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ABSTRACT 


An  important  problem  arising  from  the  increased  sharing  of  information  across 
networks  is  bandwidth  constraint.  Then  limitations  of  communications  channels  in  the 
transmission  of  volumous  information  is  the  singular  bottleneck  dictating  processing 
capability  and  robustness  of  current  and  future  distributed  systems.  Bandwidth  utilization 
with  the  goal  of  optimizing  the  actual  information  transmitted,  has  to  date,  been  ignored. 
Many  of  the  current  network  strategies,  bodi  commercial,  and  tactical,  rely  on  the 
repeated  broadcast  of  a  standardized  message.  As  a  result,  much  available  bandwidth  is 
wasted.  The  specific  approach  taken  to  maximize  specific  network  node  throughput  on  a 
digital  network  is  a  three-layer  paradigm,  managed  by  an  embedded  autonomous 
software  agent  located  at  each  network  node.  The  first  layer  consists  of  a  network 
specific  strategy  for  reducing  tihe  message  content.  The  second  layer  is  a  frame  by  frame 
analysis  of  die  reduced  message  content,  to  determine  the  best  compression  method  to  be 
applied  to  the  information  itself  (MPEG,  etc.).  Finally  a  packaging  strategy  is  utilized  to 
maximize  the  compressed  content  for  each  specific  network  packet.  The  first  phase  of  a 
proof  of  concept  prototype  has  been  implemented.  Initial  results,  via  a  network 
simulation,  have  demonstrated  a  quantative  300%  plus  increase  in  effective  information 
throughput  capability,  utilizing  the  same  bandwidth.  Since  this  approach  is  an  embedded 
technique,  existing  network  hardware,  software,  and  standards  remain  uneffected.  A  side 
benefit  witnessed  is  increased  network  responsiveness,  due  to  increased  information  flow 
in  a  timely  manner.  In  terms  of  processing  time  required,  the  cost  is  more  than 
compensated  for  by  increased  network  efficiency.  The  net  result  is  a  more  efficient  and 
responsive  network  capability.  Future  efforts  will  implement  the  entire  node  management 
capability  described  in  this  thesis.  It  is  anticipated  this  capability  will  be  introduced  to  the 
opporational  fleet  within  the  next  five  to  seven  years. 


V 


TABLE  OF  CONTENTS 


l.  INTRODUCTION  . 1 

A.  GENERAL  . 1 

B.  PROBLEM  STATEMENT  . 2 

n.  RISK  ASSESSMENT  FOUNDATION  FOR  DESIGN  PRINCIPLES  . 5 

A.  INTRODUCTION  .  5 

B.  PROBLEM  STATEMENT  . 6 

C.  GLOBAL  REAL  TIME  RETARGETING  REQUIREMENT  .  7 

D.  SCIENCE  AND  TECHNOLOGY  SHORTFALL . 8 

E.  TECHNICAL  APPROACH  . 9 

1.  General  Discussion . 9 

F.  ASSUMPTIONS  . ; . 10 

G  AGENTS  FOR  TRANSPARENT  OPTIMIZATION  OF  INFORMATION 

TRANSMISSION  . ' . 10 

H.  LINK  16  GENERAL  DISCRIPTION  . . .  12 

1.  Link- 16  Functional  Description  . 12 

2.  Link- 16  Operation  . 12 

3.  Link- 16  Configuration  . ' . 13 

I.  AGENT-BASED  TECHNIQUES  FOR  REAL-TIME  SYSTEMS  . . .  14 

1.  Introduction  . 14 

2.  Intelligent  Real-Time  Systems  (Robotics)  . 15 

3.  Real-Time  Expert  Systems  . 19 

J.  OTHER  CRITICAL  TECHNOLOGIES  . 21 

1.  Information  Theory;  Mathematics  of  Communications .  21 

m.  ENGINEERING  DESIGN  FOR  A  NODE  AGENT  . 29 

A  CODESIGN;  SOFTWARE  ENGINEERING  FOR  REAL-TIME  SYSTEMS . 29 

B.  AN  AGENT  FOR  LINK  16/22 . 32 

1.  A  Concept  . 32 

C.  SOFTWARE  REQUIREMENTS  -  A  FUNCTIONAL  DISECTION  LEADING 

TO  A  PROPOSED  DESIGN  FOR  IMPLEMENTATION  . 33 

1.  Functions  &  Operations  . 34 

D.  FUNCTIONAL  REQUIREMENTS  . 35 

E.  KNOWLEDGE-BASED  COMPONENTS  . 37 

1.  General  . 37 

2.  Semantic  Networks  . 37 

F.  FACTS  . 40 

1.  General  Forms  . 40 

2.  FactSets  . 41 

G.  PRODUCTION  RULES  .  41 

1.  General  Forms-Antecedents  and  Consequents  . 41 

2.  Comparisons  . 41 

vii 


3.  Antecedent  format  . 42 

4.  Consequents .  43 

5.  Sample  Complete  Rule  .  43 

H.  CONCATENATION  IN  THE  RULES  . "  ^  ^  ^  ^ .  44 

I.  ANY/THAT/THOSE  CONSTRUCTIONS  . ...........46 

1.  General  .  45 

2.  Subsets  . 45 

3.  Evaluation  Order  .  47 

J.  DIRECTIVES  . ’  ^  ^ V  . . 48 

1.  DEINSTANTIATE .  . 4g 

2.  LOCK/UNLOCK  . .  4S 

3.  NUMBEROF  .  49 

4.  NAMEOF  . .  ^  ^  ^  ^  ^  ^  ^  ^  .  .  .  .  ^  ^  ^  ^  49 

5.  INFER  . .  5Q 

6.  PARALLEL  . '  ^  ^  ^  ^  ^  ^  ^  ^ . 50 

K.  SPECIAL  TERMS  . .  . 50 

1.  NULL  . .  ^  ^  ^  ^  ^  ^  51 

2.  MINUS/PLUS/DIVIDED_BY  (Slot  Arithemetic)  5 1 

3.  FIELD  . 51 

4.  NCHARS .  52 

L.  VALUE  ARITHMETIC  . .  . .  ^  ^ ^ . 53 

M.  CONCATENATION  IN  NAMES  . ^  ^  ^ ^  ^  ^  ^  ^  ^  ^  ^  54 

N.  VARIABLES,  POINTERS,  AND  INDIRECTION  .  54 

O.  REASONING  WITH  UNCERTAINTY .  55 

P.  THE  AGENTENGINE  . ^  ^ ^  ^ '  55 

1.  Rule  Order  and  the  Academic  Paradigm  . 56 

2.  Automatic  Rule  Sorting  and  Parallel  Processing  . 57 

3.  Functions  within  Consequents  .  57 

4.  Nested  Inferencing  .  53 

5.  Compiling  .  53 

6.  The  WHILE  Construction  .  59 

7.  BREAK  . ^ . 59 

Q.  SHARED  MEMORY  . . ' '  ^  ^  ^  ^  ^  ^  ^  ^  ^  ^  .  59 

R.  META  CONTROL  AND  META  LANGUAGE  . ^  ^  ^  ^  ^  ^  ^  ^  ^  '  60 

1 .  Meta  Control  Functions  . .  61 

AGENT  ARCHITECTURE  . 65 

A.  LINK  MANAGER . 65 

B.  SIMPLIFYING  ASSUMPTIONS  FOR  THE  PROTOTYPE  . 67 

1 .  Left  Input  Process  .  53 

2.  Left  Output  Process  .  . .  71 

3.  Exception  Handler  .  72 

C.  DELTA  COMPONENTS  . ■ S3 

1.  Encoder  . 

viii 


2.  Decoder  . 87 

D.  SHARED  COMPONENTS  . 90 

V.  AGENT  METHODS  FOR  LINK  16  . 92 

A.  INTRODUCTION  . 92 

B.  ATOMIC  DATA  ELEMENT  TRANSMISSION  ("DELTA  MESSAGES") . 92 

C.  UPDATE  BUNDLING  . 97 

D.  EXTRAPOLATION-DRIVEN  UPDATES  . 98 

E.  TRADITIONAL  COMPRESSION . 101 

F.  EXTENSIONS  .  101 

VI.  SUMMARY  . .  103 

A.  WORK  ACCOMPLISHMENTS  . 103 

B.  WORK  TO  BE  DONE  IN  SUBSEQUENT  PHASES . 103 

Vn.  FUTURE  WORK  . .  .' . 105 

LIST  OF  REFERENCES  . . 108 

APPENDIX  . 113 

INITIAL  DISTRIBUTION  LIST  .  171 


ix 


X 


LIST  OF  ACRONYMS 


agent 

RTR 

C2P 

JTIDS 

GDLMS 

RF 

link 


in  the  context  of  this  thesis,  a  goal  seeking,  semi-intelligent,  independent 
program  working  on  behalf  of  a  host  system  to  increase  efficiency 

real  time  retargeting 

command  control  processor 

Joint  Tactical  Information  Distribution  System,  the  system  name  for  a 
spread  spectrum,  anti-jam,  means  of  time  synchronized,  digital 
communication 

Common  Datalink  Management  System 
radio  frequency,  as  in  RF  transmissions 

herein  referes  to  military  specific  digital  communications  networks  operating 
over  a  radio  frequency  spectrum  (RF) 
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1. 


INTRODUCTION 


A.  GENERAL 

The  advent  of  the  computer  age  has  brought  about  a  plenitude  of  benefits  to  the  human 
race.  Included  with  these  benefits  has  been  the  ever  increasing  demand  to  transfer  exponentially 
increasing  amounts  of  information,  and  the  associated  problems  of  information  sharing.  The 
focus  of  this  thesis,  associated  Naval  Science  Assistance  Program  (NSAP),  and  Office  of  Naval 
Research  (ONR)  funded  research  effort,  has  been  to  best  utilize  available  digital  communications 
assets  in  the  radio  frequency  (RF)  spectrum  to  allow  sufficient  transfer  of  information  providing 
DOD  assets  flexible,  rapid,  and  in-flight  reprogramming,  re-planning  of  strike  and  cruise  missile 
assets,  to  engage  a  high  value,  emergent  target,  in  the  shortest  possible  time.  The  postulated 
methods  of  utilizing  autonomous  agents  to  manage  information  flow  across  network  nodes  has 
applicability  to  all  digital  networks. 

Based  upon  the  pioneering  work  of  Pattie  Maes,  at  Massachusetts  Institute  of  Technology 
(MIT)  (4,  17,  31,  33,  53,  54),  and  previous  examination  of  communications  node  management 
(37,  38),  the  implementation  of  independent  processes,  working  on  behalf  of  a  host  system,  to 
optimize  the  effective  meaningful  throughput  on  a  communications  channel  is  not  only 
desirable,  but  necessary.  The  evolution  of  semi  intelligent  software,  whether  called  Artificial 
Intelligence,  Intelligent  Agents,  or  Autonomous  Agents,  has  reached  a  level  of  sophistication 
allowing  the  insertion  of  meamngful  articulated  processes  within  existing,  and  future  systems 
maximize  the  network  efficiency  systematically.  Recent  work  by  Michael  Cohen  on  Sodabots 
(8),  and  the  evolution  of  user  interactive  TinyMUDs  (Multiple  User  Dimension)  of  the  Maas- 
Neotek  family  (4),  a  virtual  type  personality  environment,  has  demonstrated  the  ability  of 
software  to  deal  with  dynamic  and  changing  conditions.  The  additional,  and  exponential  increase 
in  micro-processor  power  has,  for  the  first  time,  made  available  the  hardware  for  such  agent 
implementations  as  compact,  self  contained,  embedded  systems,  in  direct  support  of  larger 
existing  systems. 
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B.  PROBLEM  STATEMENT 

At  present,  tactical  command  and  control  networks,  such  as  Link  16,  do  not  employ  data 
management  techniques  to  maximize  the  utilization  of  the  RF  spectrum.  With  respect  to  the 
surveillance  Net  Participation  Group  (NPG),  information  updates  on  platform  tracks  are 
transmitted  in  full  and  at  a  high  rate.  This  is  true  even  when  only  a  single  data  field  (e.g.,  the 
location)  of  the  track  information  has  changed.  The  rapid  repetition  of  redundant  information  is 
a  characteristic  of  other  NPGs  as  well.  One  of  the  reasons  for  this  repetition  is  that  a  listener,  if 
he  misses  a  message,  can  simply  ignore  it — another  chance  to  receive  the  information  will  soon 
follow.  An  important  drawback  of  this  passive  design,  however,  is  that  the  bandwidth  needed  to 
support  RTR  requirements  will  not  be  available. 

It  is  assumed  that  no  new  tactical  networks  (hereinafter  referred  to  as  “links”)  will  be 
available  for  the  foreseeable  future,  and  certainly  not  in  time  to  meet  the  needs  of  the  RTR 
Cruise  Missile  demonstration  and  the  RTR  program  that  supports  it. 

Therefore  every  effort  must  be  made  to  obtain  more  efficient  use  of  bandwidth  from 
existing  links.  There  are  five  methods,  independent  of  efforts  to  handle  network  entry,  and 
passive  synchronization,  that  this  effort  will  explore:  Atomic  Data  Element  Transmission, 
Update  Bundling,  Extrapolation-Driven  Updates,  Traditional  Compression,  and  Active  Network 
Management.  In  FY96,  message  size  reduction  was  demonstrated  on  a  closed  loop  link 
simulation,  built  upon  existing  assets.  These  initial  achievement  are  leading  toward  benchmark 
demonstrations  utilizing  NRaD’s  Systems  Integration  Facility  (SIF)  to  establish  best-case 
effectiveness.  In  later  years,  benchmarks  will  be  established  for  additional  techniques. 

The  ultimate  aim  is  to  increase  the  available  bandwidth,  through  efficient  and  more 
formal  management  of  existing  tactical  networks,  without  changing  network  operation  rules  or 
message  integrity  assurance.  This  capability  will  result  in  a  new  way  of  handling  information  on 
existing  links,  with  the  possibility  of  extending  capability  to  a  new  message  specification  while 
coexisting  within  the  given  operational  network. 


As  demonstrated  by  the  news  presented  every  day,  reactionism  is  ever  increasing  in 
today’s  complicated  world.  The  demise  of  the  former  Soviet  Union  has  eased  the  potential  for 
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armed  exchanged  by  responsible  parties,  but  has  dramatically  increased  the  potential  of 
hostilities  with  the  slightest  trigger  event  leading  to  potential  larger  exchanges,  and  loss  of  life. 

A  small  trigger  event 


can  lead  to  aggression 


leading  to  a  response 


leading  to  escalation 


leading  to  a  larger  response 


all  within  a  very  short  period  of  time.  One  key  point  to  bear  in  mind,  even  the  smallest  have  not 
organizations,  or  countries  have  access  to  weapons  of  mass  destruction.  The  rational  mindset 
does  not  necessarily  apply  here,  therefor  the  need  for  rapid  response  dictating  efficient 
communications  throughput  capacity. 


II.  RISK  ASSESSMENT  FOUNDATION  FOR  DESIGN  PRINCIPLES 


A.  INTRODUCTION 

This  document  describes  the  engineering  design  of  an  autonomous  or  knowledge-based 
agent  designed  to  increase  effective  throughput  on  tactical  links.  The  agent  itself  is  called 
“Agent,”  and  each  instance  of  the  agent  is  identical  on  all  nodes  in  the  network.  The  sole 
assumption  made  by  the  architecture  is  that  each  node  on  the  network  will  have  an  agent 
associated  with  it  able  to  intercept  and  manipulate  both  incoming  and  outgoing  messages. 

The  architecture  is  knowledge-based  in  all  other  respects.  Thus  it  is  not  specific  to  any 
particular  tactical  link  or  digital  network.  To  operate  on  some  other  network  requires 
modifications  to  the  knowledge  bases  and  facts,  but  no  modifications  to  the  agent  itself. 

This  document  is  not  intended  to  function  as  a  tutorial  for  knowledge-based  systems 
concepts.  It  assumes  a  high  level  of  sophistication  in  traditional  concepts  and  addresses  where 
the  engineering  design  departs  from  them.  Neither  is  this  document  intended  to  be  a  tutorial 
about  Link- 16  or  other  tactical  communications  networks. 

The  principal  accomplishment  was  the  design  of  an  inference  engine  specifically  tailored 
for  intelligent  agents.  The  special  features  of  this  inference  engine  are  described  in  depth  so  that 
detailed  designers  can  know  what  to  do. 

Each  process  in  the  system  is  controlled  by  meta  rules  and  a  special  meta  controller  that 
is  part  of  the  agent  run-time  environment.  Although  an  elaborate  meta  language  was  designed, 
adding  sophistication  to  the  inference  engine  reduced  reliance  on  sophisticated  meta  rules.  Very 
few  functions  are  involved  at  present. 

The  run-time  environment  for  the  agent  was  not  designed.  The  assumption  was  that  one 
or  more  commercial  agent-building  tool  kits,  such  as  IBM’s  ABE  (Agent  Building  Environment) 
would  be  available  to  initialize  and  run  the  agent.  Since  these  tool  kits  can  be  modified  to  use  a 
custom  inference  engine,  and  because  the  facts  and  rules  used  by  the  Agent  system  can  in 
general  be  translated  to  and  from  KIF,  the  assumption  that  a  tool  kit  would  be  available  at  the 
time  of  detailed  design  seems  reasonable  to  the  author.  However,  there  is  nothing  in  this  system 
that  requires  the  use  of  such  a  tool  kit.  The  run-time  mechanisms  necessary  to  control  the 
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processes  and  mferencmg  are  not  complicated.  This  supports  an  implementation  structure  in 
which  the  agent  can  run  on  its  own  machine  inserted  at  each  node  between  the  node  and  the 
network. 

This  document  assumes  Link- 16  concepts  but  the  methods  of  autonomous  agents  are  not 
specific  to  Link- 16. 

B.  PROBLEM  STATEMENT 

At  present,  tactical  command  and  control  networks,  such  as  Link  16,  do  not  employ  data 
management  techniques  to  maximize  the  utilization  of  the  RF  spectrum.  With  respect  to  the 
surveillance  Net  Participation  Group  (NPG),  information  updates  on  platform  tracks  are 
transmitted  in  full  and  at  a  high  rate.  This  is  true  even  when  only  a  single  data  field  (e.g.,  the 
location)  of  the  track  information  has  changed.  The  rapid  repetition  of  redundant  information  is 
a  characteristic  of  other  NPGs  as  well.  One  of  the  reasons  for  this  repetition  is  that  a  listener,  if 
he  misses  a  message,  can  simply  ignore  it — another  chance  to  receive  the  information  will  soon 
follow.  An  important  drawback  of  this  passive  design,  however,  is  that  the  bandwidth  needed  to 
support  information  exchange  requirements  will  not  be  available. 

It  is  assumed  that  no  new  tactical  networks  (hereinafter  referred  to  as  “links”)  will  be 
available  for  the  foreseeable  future. 

Therefore  every  effort  must  be  made  to  obtain  more  efficient  use  of  bandwidth  from 
existing  links.  There  are  five  methods,  independent  of  efforts  to  handle  network  entry,  and 
passive  synchronization,  that  this  effort  will  explore:  Atomic  Data  Element  Transmission, 
Update  Bundling,  Extrapolation-Driven  Updates,  Traditional  Compression,  and  Active  Network 
Management.  In  FY96,  message  size  reduction  was  demonstrated  on  a  closed  loop  link 
simulation,  built  upon  existing  assets.  These  initial  achievements  are  leading  toward  benchmark 
demonstrations  utilizing  Naval  Research  Development  Test  &  Evaluation  (NRaD)  Systems 

Integration  Facility  (SIF)  to  establish  best-case  effectiveness.  In  later  years,  benchmarks  will  be 
established  for  additional  techniques. 

The  ultimate  aim  is  to  increase  the  available  bandwidth,  through  efficient  and  more 
formal  management  of  existing  tactical  networks,  without  changing  network  operation  rules  or 
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message  integrity  assurance.  This  capability  will  result  in  a  new  way  of  handling  information  on 
existing  links,  with  the  possibility  of  extending  capability  to  a  new  message  specification  while 
coexisting  within  the  given  operational  network. 


C.  GLOBAL  REAL  TIME  RETARGETING  REQUIREMENT 


The  basis  for  this  thesis  was  guided  by  sponsor  desires  to  support  rapid  mission  re¬ 
allocation  of  assets  in  support  of  emergent  threats  on  a  real  time  basis.  FY96  Program  Execution 
Plan  for  Real-Time  Retargeting  (RTR)  provides  a  good  list  of  the  general  requirements  for  real¬ 
time  retargeting,  and  basis  by  which  the  concept  and  development  of  agents  is  being 
accomplished: 

The  ONR  Real-Time  Retargeting  (RTR)  Accelerated  Capability  Initiative  (ACI)  is  aimed 
at  providing  the  cruise  missile  and  tactical  aircraft  warfighters  a  new  capability  to 
redirect  their  strike  forces  in  real-time  to  respond  to  current  dynamics  of  the  battlefield. 

The  focus  of  the  ACI  is  on  time-critical  targets.  To  engage  such  targets,  these 
warfighters  must  plan/replan,  control,  and  execute  strikes  in  5  to  30  minutes,  instead  of 
the  military’s  current  operational  capability  of  many  hours.  Current  shortfalls  that  inhibit 
these  warfighters  from  responding  in  real-time  are:  (1)  lack  of  automated  real-time 
mission  (re)planning  capability,  (2)  lack  of  communications  availability  and  capacity,  (3) 
lack  of  automated  target  detection  and  recognition,  (4)  lack  of  rapid  mission  management 
and  execution  decision  aids,  (5)  lack  of  real-time  terminal  targeting  information 
dissemination  between  surveillance  assets  and  strike  platforms,  and  jjotentially  between 
the  strike  platforms  themselves,  and  (6)  lack  of  necessary  available  bandwidth  to  support 
robust  rapid  data  transmission  in  support  of  RTR.  This  equates  into  a  lack  of  real-time 
threat  awareness  on  board  the  strike  platform. 

Shortfalls  two  and  six  are  addressed  by  this  effort.  Without  requiring  a  change  to  the  net 
protocols  or  integrity  assurance,  this  effort  is  developing  methods  for  extending  the  effective 
bandwidth  of  existing  tactical  networks.  By  utilizing  algorithms  and  system  structures  which  are 
typically  not  associated  with  throughput  optimization,  substantial  improvements  can  be  realized 
for  extending  the  communications  capabilities  of  existing  networks.  The  technologies  developed 
by  this  research  will  support  the  capabilities  of  Tomahawk  Block  IV+  or  TSTAR.  It  will  also 
apply  to  any  digital  network  through  optimization  of  available  bandwidth.  This  effort  is  not  a 
cure-all  for  network  bottlenecks,  but  rather  a  best  use  of  what  is  available. 
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D.  SCIENCE  AND  TECHNOLOGY  SHORTFALL 

Link  16  is  predominately  a  passive  system.  This  means  that  messages,  such  as  track 
updates,  are  transmitted  so  frequently  that  they  need  not  be  acknowledged  by  receiving 
platforms.  Therefore,  if  a  platform  misses  a  message,  it  need  only  wait  a  few  seconds  for  an 
update.  The  goal  of  the  design  within  the  surveillance  NPG  is  to  provide  a  complete  tactical 
picture  m  twelve  seconds  or  less,  for  as  many  as  two  thousand  tracks.  Although  the  total  load  on 
the  link  by  the  surveillance  NPG  is  not  as  great  as  that  produced  by  voice  communications  or 
video  conferencing,  it  is  significant  nevertheless. 

In  order  to  adapt  the  link  to  RTR  requirements,  both  transmitting  and  receiving  platforms 
need  to  be  smarter,  reducing  both  the  level  of  redundancy  in  the  messages  and  the  frequency 
with  which  they  are  transmitted.  The  idea  is  to  insert  processor  capability  between  the  C2P  and 
the  JTIDS  terminal  on  all  platforms  to  distribute  network  control  and  manage  message  content  in 
a  smarter  way.'  Because  of  the  complexity  of  the  rules  of  the  network  and  the  communications 
between  C2P  and  JTIDS,  an  agent  based  architecture  is  the  ideal  candidate:  it  is  designed  to 
operate  transparently,  can  take  action  on  its  own  volition,  is  extensible  and  flexible,  and  is 
capable  of  being  included,  and  /  or  integrated,  in  future  system  upgrades,  and  will  handle  the 
complexity  of  network  entry  /  passive  synchronization,  while  maintaining  maximized  throughput 
capability  of  only  “changed”  information.  Distributed  control  architectures  in  an  object-oriented 

environment  can  produce  smart  and  complex  behaviors  that  are  not  generally  achievable  with 
traditional  techniques. 


'  The  eventual  target  for  this  work  is  probably  the  CDLMS  effort  (Common  Data  Lin 
which  will  at  some  point  produce  a  system  replacing  the  current  C2P. 


Management  System), 
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E.  TECHNICAL  APPROACH 


1.  General  Discussion 

Depending  upon  available  resources,  the  approach  to  the  FY96  tasks  was  to  establish 
performance  objectives  and  baselines.  Sanitized  data  from  actual  network  operations  were 
acquired  from  the  Systems  Integration  Facility  (SIF).  This  data  established  baseline  for 
evaluating  redundancies  in  network  communications.  From  this  data,  a  decrease  in  loading  is 
expected  to  result  from  the  technique(s)  being  developed  by  this  effort.  Additional  candidate 
techniques  are  under  development  and  will  be  tested  separately. 

The  software  written  to  date  has  employed  reusable,  object-oriented  methods/techniques. 
A  need  for  a  real-time  object-oriented  data  base  management  system  (OODBMS)  is  anticipated 
as  system  capabilities  are  developed.  The  system  architecture  is  designed  to  incorporate  such 
tools  as  they  are  needed  and  can  be  exploited.  Also,  a  PMW  159  sponsored  effort  called  the 
Common  Data  Link  Management  System  (CDLMS),  will  result  in  an  object-oriented  tactical 
communication  system.  Thus,  employing  an  object  oriented  style  will  reduce  costs  for  future 
integration  efforts. 

A  number  of  commercial  OODBMS’s,  such  as  ObjectStore,  Versant,  ONTOS,  and 
Polyhedra,  are  under  consideration  and  are  to  be  evaluated  as  the  need  arises.  Their  ability  to 
satisfy  real-time  demands  of  link  messaging,  is  considered  a  critical  feature.  The  ability  to 
manage  storage  and  retrieval  of  temporal  data,  is  also  a  critical  factor. 

Finally,  objects  are  by  defimtion,  independently  executing  processes  that  are  designed  for 
maintainability  and  reuse.  From  their  hierarchical  orientation,  the  levels  of  abstraction  in  object 
oriented  systems  are  more  explicit  and  straightforward  than  traditional  styles.  As  the  initial 
exploratory  efforts  are  performed,  and  lower  level  object  methods  are  created,  developing  more 
abstract  levels  of  processing  is  relatively  fast,  reliable,  and  adaptable  toward  new  capabilities. 
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F.  ASSUMPTIONS 


The  following  assumptions  are  made  with  respect  to  the  proposed  modifications 
suggested  herein: 

•Any  modifications  made  between  two  C2P  /  JTIDS  terminal  linkages  can  be 
accomplished,  as  long  as  the  rules  for  the  particular  network  in  question  are  followed. 

•Messages  will  have  specific  data  elements  recognizable  to  the  C2P.  As  for  transmission 
methods  are  concerned,  data  is  data,  and  can  be  manipulated  as  desired,  so  long  as  the 
reconstituted  message  elements  follow  the  assumption  above  and  do  not  violate  any  link 
integrity  requirements. 

•Link  rules  enforce  standards.  As  long  as  the  end  results  obey  link  rules,  the  proposed 
modifications  can  be  performed,  given  timeliness  and  robustness  are  maintained. 

•Rules  evolve  as  systems  evolve,  tactics  change,  and  lessons  are  learned.  Software 
designed  under  this  effort  is  flexible,  allowing  changes  in  rules  without  forcing  system  redesign. 

G.  AGENTS  FOR  TRANSPARENT  OPTIMIZATION  OF 
INFORMATION  TRANSMISSION 

An  agent  is  a  relatively-independent  software  entity,  or  collection  of  such  entities,  that 
performs  tasks  on  behalf  of  human  users  but  also  can  perform  on  behalf  of  other  computer 
applications  or  systems.  There  are  two  important  features  of  software  agents.  First,  they  are 
anthropomorphic  processes.  As  much  as  possible,  agents  behave  and  communicate  in  ways  that 
are  similar  to  and  compatible  with  human  behavior  and  communication.  As  such,  they  are  not 
necessarily  “smart”  or  “intelligent,”  but  like  humans,  they  tend  to  be  goal  driven. 

Resource  management  is  a  common  task  for  software  agents.  In  this  capacity,  they 
operate  at  a  higher  level  of  abstraction  than  the  user  or  system  they  oversee.  Often  they  are 
separate  processes  initiated  prior  to  the  initiation  of  the  system  they  oversee.  Like  human 
managers,  they  are  able  to  “watch”  user  or  system  operations,  detect  problems,  formulate 

corrective  plans,  and  carry  them  out.  Some  can  study  the  effects  of  their  interventions  and 
modify  their  behavior  accordingly. 
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Distributed  set  of  intelligent  agents  may  provide  the  means  and  method  for  overseeing 
the  operations  of  an  operational  network  such  as  Link- 16.  Present  at  each  platform,  observing 
transmissions,  received  messages,  and  user  interactions,  agents  can  be  designed  to  optimize  link 
performance  and  enhance  operator  efficiency. 

In  late  1996,  a  demonstration  capability  was  developed  and  an  initial  evaluation  of 
network  messages  was  performed.  In  1997,  an  initial  design  of  a  software  agent,  hereinafter 
called  “Agent,”  was  prototyped  (proof  of  concept),  while  longer-range  architectural  ideas  are 
considered.  In  the  out  years,  the  final  agent  architecture  will: 

•Accommodate  the  differing  needs  of  different  platforms  without  recoding; 

•Understand  the  rules  of  the  links  so  that  all  its  actions  will  conform  to  them; 

•Be  extensible,  either  directly  or  through  cloning  with  different  knowledge  bases, 
to  other  messages  and  functions; 

When  a  message  is  sent  fi’om  die  C2P  to  the  JTIDS,  the  agent  determines,  by  checking  its 
type,  vriiether  or  not  it  is  of  interest.  If  it  is  not,  the  message  is  simply  reasserted  on  the  outgoing 
bus. 

The  design  goal  for  Agent  architectures  is  to  be  able  to  accommodate  future  functional 
requirements  by  adding  additional  knowledge,  leaving  the  engines  and  interpreters  largely  intact. 
The  result  is  a  system  diat  can  be  extended  at  minimal  cost. 

The  key  design  issue  is  real-time  performance.  In  general,  the  higher  the  level  of 
abstraction,  the  higher  the  overhead.  Therefore,  particular  implementations,  such  as  Link  16,  are 
driven  by  the  time  constraints  of  the  links,  available  system  resources,  and  scalability  of  the 
agent-based  architecture.  Fortunately,  agent-based  architectures  for  Intelligent  Real-Time 
Systems  and  Real-Time  Expert  Systems,  have  addressed  similar  hard  real-time  constraints.  This 
work  draws  upon  those  results. 
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H. 


LINK  16  GENERAL  DESCRIPTION 


1.  Link-16  Functional  Description 

Link-16,  or  TADIL  1,  uses  the  Joint  Tactical  Information  Distribution  System.  JTIDS 
refer  to  the  communication  component  of  Unk-16  that  encompasses  the  software,  hardware,  RF 
equipment  and  the  wavefoim  that  they  generate.  Among  NATO  subscribers,  the  equivalent  teim 
for  JTIDS  is  the  Multifunctional  Information  Distribution  System  (MIDS).  Link-16  employs 
netted  communication  techniques  and  a  standard  message  format  for  exchanging  digital 
information  among  airborne,  land-based  and  shipboard  tactical  data  systems.  Link-16  does  not 
significantly  change  the  basic  concepts  of  tactical  data  link  infoimation  exchange  supported  for 
many  years  by  Link-1 1  and  Lmk-4A.  Link-16  provides  technical  and  operational  improvements 
to  existing  tactical  data  link  capabilities.  The  improvements  include  nodelessness;  electronic 
countermeasure  (ECM)  resistance;  flexibility  of  communication  operations;  separate 
transmission  and  data  security;  increased  number  of  participants;  increased  data  capacity; 
network  navigation  features;  and  secure  voice.  Link- 1 6  also  uses  a  Time  Division  Multiple 
Access  (TDMA)  architecture,  which  provides  multiple  and  simultaneous  communication  nets. 


2.  Liok-16  Operation 

Link-16  operates  at  L-band  frequencies  (969  -  1206  MHz)  with  3  MHz  channel  spacing 
and  a  power  output  of  200  -  1260.  It  transmits  a  fiequency-hopping  transmission  pattern  using 
51  ftequencies  at  3  MHz  intervals,  excluding  identification  ftiend  or  foe  (IFF)  sub-bands. 
Frequency-hopping  and  other  spread-spectrum  techniques  make  Link-16  resistant  to  jamming 
and  data  encryption  makes  it  secure.  The  Lirrk-16  message  standard  consists  of  one  or  more  70- 
bit  rvords  plus,  error  detection,  correction  bits,  and  symbols.  The  word  formats  are  used  to  allow 
a  single  message  to  convey  position,  track  data,  weapons  control  and  command  messages. 
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3. 


Link-16  Conflguration 


The  major  components  of  the  Navy  shipboard  Link- 16  system  include  the  following: 
Tactical  Data  System  (TDS),  Command  and  Control  Processor  (C2P),  JTIDS  terminal  and 
JTIDS  antennas.  The  TDS  and  C2P  provide  the  tactical  data  to  be  exchanged.  The  JTIDS 
terminal  and  antennas  provide  the  secure,  anti-jam,  increased  capacity  waveform.  The  JTIDS 
terminal  is  composed  of  two  major  components:  the  receiver/transmitter  (R/T)  and  the  data 
processor  group  (DPG).  The  R/T  is  common  to  all  platforms.  The  DPG  contains  a  digital  data 
processor  and  an  interface  unit  (lU).  The  lU  is  tailored  specifically  to  each  type  of  platform. 

There  are  two  configurations  of  Link- 16,  known  as  Model  4  and  Model  5.  The  Model  4 
implementation  of  Link-16-also  referred  to  as  Block  0  on  Advanced  Combat  Direction  System 
(ACDS)  platforms-was  designed  as  a  transparent  equipment  upgrade  to  existing  ship’s  tactical 
systems.  Model  5-also  referred  to  as  Block  1  on  ACDS  platforms-is  the  full  and  complete 
implementation  of  Link- 16  in  accordance  with  OSS  161. 


Figure  1 
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Figure  2 


Figure  3 


I.  AGENT-BASED  TECHNIQUES  FOR  REAL-TIME  SYSTEMS 


1.  Introduction 


The  following  summary  is  from  Huang  [63]: 

George  Saradis  introduces  a  three-level  hierarchy  [Saradis,  1985],  Acar  and  Ozguner 
present  an  alternative  architecture  that  organizes  the  system  into  a  multiresolution 
hierarchy  by  identifying  its  components  and  examining  the  physical  relationships  among 
them  [Acer  and  Ozguner,  1990],  Antsaklis  and  Passino  describe  a  hierarchical  control 
architecture  that  uses  a  hybrid  approach  to  model  systems  with  a  high  degree  of 
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autonomy  [Antsaklis  and  Passino,  1993].  Successive  delegation  of  duties  from  higher  to 
lower  levels  is  one  of  this  hierarchy’s  important  characteristics.  In  another  chapter  of 
Antsaklis  and  Passino,  Meystel  describes  a  nested  hierarchical  control  theory  that 
includes  the  concept  of  treating  design  and  control  as  a  continuum  [Meystel,  1993]. 

Regarding  implementation  of  intelligent  control  systems,  research  has  focused  on 
software  technologies  and  computer-aided  software-engineering  environments.  Sweet 
and  his  colleages  identify  key  software  technologies  for  the  Aerospace  Industries 
Association  [Sweet  et  al,  1989].  Simmons  describes  a  Task  Control  Architecture 
[Simmons  1990].  One  limitation  of  TCA  might  be  scalability  because  it  is  not  intended 
to  model  multiple-cooperating  agents.  Object-oriented  paradigms  are  becoming  popular 
for  handling  the  representation  problems  of  software  systems,  but  they  are  not  suitable 
for  all  problems.  For  example,  Schneider  and  his  colleagues  developed  a  flexible,  object- 
oriented,  real-time  software  implementation  tool  called  ControlShell  [Schneider  et  al., 
1994].  But  this  tool  does  not  address  the  issue  of  architecture;  periiaps  a  reference-model 
architecture  could  complement  its  capabilities. 


Huang  is  at  the  National  Institute  of  Standards  and  Technology  (NIST)  where,  for  over 
two  decades,  Jim  Albus  has  been  developing  the  Real-Time  Control  System  (RCS)  reference- 
model  architecture.  A  reference-model  does  not  describe  how  system  structures  are  represented 
and  implemented,  but  rather  seek  to  conceptualize  the  high  level  functionality  and  process 
interdependency.  Object-oriented  (OO)  paradigms  have  become  popular  because  they  can 
reflect  the  inherent  structure  of  reference  models.  Given  a  reference  model  or  system 
architecture,  the  actual  implementation,  as  driven  by  the  model  or  architecture,  is  typically  a 
separate  design  effort.  Intelligent  real-time  system  architectures  are  discussed  in  more  detail  in 
the  next  section. 


2.  Intelligent  Real-Time  Systems  (Robotics) 

An  approach  and  methodology  for  engineering  intelligent  real-time  systems  is  discussed 
by  Durham  [44,  45,  46].  In  terms  of  systems  architectures,  Durham  considers  intelligent  real¬ 
time  systems  functionally  equivalent  to  intelligent  robot  systems.  The  two  types  of  systems  share 
similar  requirements  and  objectives,  and  only  differ  in  terms  of  the  “plant”  or  environment  for 
which  they  interact.  When  a  robotic  agent  interacts  with  a  subset  of  a  system  such  that  its  “plant” 
is  restricted  to  system  software,  such  agents  have  been  called  “softbots,”  i.e.  software  robots. 
Soflbot  applications  do  not  typically  have  hard  real-time  requirements  and  the  real-time 
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limitations  of  softbots  is  an  open  issue.  To  address  such  issues,  this  effort  capitalizes  on  the 
recent  advances  in  autonomous  systems  and  telerobotics. 

Figure  4,  below  is  a  diagram  of  a  generic  intelligent  system  architecture  derived  from 
some  early  results  in  the  ARPA  Autonomous  Land  Vehicle  (ALV)  program.  Figure  5  is  from 
Meystel’s  recent  work  in  “Semiotic”  system  architectures  [59].  These  diagrams  illustrate  the 
generic  high  level  architecture  of  real-time  intelligent  systems. 


Figure  4 


Figure  5 

Figures  6  and  7  are  two  diagrams  from  an  intelligent  system  architecture  as  described  by 
Valavams  and  Sandis  [60].  These  diagrams  frirther  illustrate  a  frmctional  organization  and 
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layering.  The  highest  level  processes  are  similar  to  the  executive  level  within  a  business 
organization.  Longer  term  organizational  structures,  such  as  strategies  and  mission  statements, 
are  the  types  of  objects  and  data  structures  to  be  processed.  The  coordination  of  day-to-day 
operations  is  a  lower  level  management  function.  Specification  and  design  of  specific  tasks  is  a 
critical  “coordinator”  function.  Finally,  the  labor  of  humans  and  machines  actually  execute  the 
operations  of  the  organizational  entity.  A  “topology”  of  organizational  structure  has  emerged 
from  previous  efforts  in  real-time  intelligent  systems. 
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These  diagrams  illustrate  an  anthropomorphic  model  for  intelligent  real-time  systems 
design.  This  type  of  system  architecture  exhibits  a  number  of  properties.  First,  a  hierarchy  of 
processes  is  defined.  The  “higher  level”  processes  require  more  “abstract”  processing  such  as 
symbol  creation  and  manipulation.  “Lower  level”  processes  directly  interact  with  the 
environment.  For  Agents,  the  environment  is  the  message  data  stream.  Secondly,  timing 
requirements  tend  to  be  inversely  proportional  to  the  level  of  a  process.  Low  level  processes 
need  to  be  highly  responsive.  High  level  processes  are  often  very  slow  to  respond.  This  layering 
of  timing  requirements  allows  a  system  to  maintain  sufficient  interaction  with  its  environment 
while  working  to  improve  its  capabilities.  The  “scope”  of  systems  processes  tends  to  be  layered 
in  a  similar  manner.  Higher  level  processes  incorporate  system-wide  and  long  range  datf^ 
elements,  i.e.  they  process  the  “big”  picture.  Low  level  processes  have  well  defined  and  narrow 
tasks  tailored  to  specific  increments  of  time.  This  leads  to  a  third  characteristic  of  intelligent 
real-time  systems.  They  are  structured  such  that  an  “abstract”  “high  level”  goal  or  set  of  goals 
can  be  designed  and  understood  without  explicit  attention  to  the  numerous  run-time  or 
operational  details.  The  system  is  designed  to  map  the  high  level  goals  into  a  set  of  lower  levels 
functions  necessary  to  achieve  the  given  goal(s).  Lower  level  processes,  such  as  control  loops, 
have  their  own  low  level  goals,  such  as  set  points.  The  specific  low  level  processes  performed  at 
specific  points  in  time  are  determined  by,  or  at  least  influenced  by,  higher  level  processes. 

Figure  8  is  also  firom  Valavams  and  Saridis  [60].  This  diagram  illustrates  that  intelligent 
control  is  the  intersection  of  three  separate  areas  of  work.  The  requirements  and  objectives  of 
Intelligent  Control  inherently  overlap  with  Artificial  Intelligence,  Operations  Research,  and 
Control  Theory.  Each  one  of  these  disciplines  in  turn  interact  with  each  other  and  define  a 
number  of  specialized  subdisciplines.  From  this  orgamzational  perspective,  a  systems  designer 
can  recognize  that,  if  properly  managed,  a  considerable  amount  of  knowledge  and  talent  can  be 
utilized  for  a  real-time  system  application  such  as  throughput  optimization  of  communications 
networks.  The  development  and  demonstration  of  this  technology  insertion  capability  is  central 
to  the  Agent  concept.  A  mechanism  for  efficiently  and  effectively  inserting  new  capabilities  into 
operational  legacy  systems  is  a  primary  objective  and  focal  concern. 
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3.  Real-Time  Expert  Systems 

Expert  systems  are  not  typically  real-time  systems  in  terms  of  their  inherent  architecture. 
The  heuristic  search  algorithms  typically  employed  are  not  guaranteed  to  meet  hard  real-time 
requirements.  A  number  of  intelligent  control  systems  employ  “Expert  System”  algorithms  and 
perform  within  their  requirements.  Expert  systems  have  become  an  integral  component  of 
intelligent  systems,  but  their  application  tends  to  be  best  for  “organizational”  processes.  Fuzzy 
logic  expert  system  techniques  have  been  recently  demonstrated  and  they  may  prove  to  be  quite 
valuable  at  the  coordination  and  execution  level  of  the  Agent  processes  [61]. 
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Figure  9 
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J. 


OTHER  CRITICAL  TECHNOLOGIES 


1.  Information  Theory:  Mathematics  of  Communication 


a.  Definition  of  Information 


The  following  is  from  Hamming  [49]; 

Suppose  that  we  have  the  source  alphabet  of  q  symbols  s,,  S2,  ...  ,  s,,  each  with  its 
probability  p(s,)  =  pi,  p(S2)  =  pj, ...  ,  p(s,)  =  p,.  When  we  receive  one  of  these  symbols, 
how  much  information  do  we  get  ?  For  example,  if  p,  =  1  (and,  of  course,  all  the  other  p; 

=  0),  then  there  is  no  “surprise,”  no  information,  since  you  know  what  the  message  must 
be.  On  the  other  hand,  if  the  probabilities  are  all  very  different,  then  when  a  symbol  with 
low  probability  arrives,  you  feel  more  surprised,  get  more  information,  than  when  a 
symbol  with  a  higher  probability  arrives.  Thus  information  is  somewhat  inversely  related 
to  the  probability  of  occurrence. 

From  an  information  theoretic  perspective,  “surprise”  is  associated  with  the  probability 
of  a  communication  event.  Data  can  be  transmitted  but  unless  there  is  a  lack  of  predictability, 
there  is  no  surprise  and  therefore  no  information  content.  Agent  based  communication  links 
capitalize  on  this  understanding  of  information  content.  There  are  a  number  of  ways  that  the 
degree  of  “surprise”  can  be  taken  out  of  network  messages.  Traditional  data  compression 
techniques  capitalize  on  a  relatively  small  number  of  possible  approaches.  Traditional  data 
compression,  and  coding  theory  in  general,  will  be  exploited  and  incorporated  within  the  Agent 
architecture,  but  this  is  not  the  technology  being  developed. 

Agent  based  communications  should  not  be  confused  with  data  compression 
technologies.  Through  efficient  management  and  accounting  of  what  is  known,  or  can  be  known 
before  messages  are  transmitted,  agent  based  communication  links  share  the  knowledge  in  a 
manner  such  that  there  is  less  “surprise”  in  the  messages  transmitted.  Thus,  Agents  are  able  to 
communicate  such  messages  with  fewer  bits. 

By  incorporating  engineering  and  design  knowledge  of  the  platform  tracks,  the  behavior 
of  the  tracks  becomes  predictable  and,  thus,  less  of  a  surprise  from  one  message  to  the  next. 
Agent  based  communication  also  provides  a  mechanism  for  incorporating  command  and  control 
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(C2)  knowledge.  For  C2,  different  track  types  typically  have  different  operational  requirements 
for  position  resolution  and  update  rate  resolution,  the  operational  requirements  for  actual 
message  transmission  times  and  resolutions  can  be  known  before  messages  are  transmitted,  and 
therefore,  the  track  messages  can  be  commimicated  at  a  lower  rate  with  fewer  bits  per  message. 
Also  note  that  redundancy  can  be  added  when  operationally  required  for  increasing  the 
confidence  that  messages  will  be  received. 

Agents  are  network  processes  that  have  a  primary  goal  of  identifying  and  sharing  system 
knowledge  that  is  not  shared  by  the  current  communication  links.  One  of  the  assumptions,  as 
stated  earlier,  is  that  with  minimal  impact,  such  a  collection  of  processes  can  be  inserted  into  an 
existing  communication  network.  With  Agents,  otherwise  unutilized  knowledge  is  flien  used  to 
take  the  “surprise”  out  of  the  messages  as  they  were  originally  communicated.  Agents  exploit 
knowledge  within  the  scope  and  bounds  of  typical  data  compression  methods,  but  data 
compression  is  not  die  technology  under  development.  Data  compression  related  knowledge  is 
considered  a  relatively  small  portion  of  the  system  wide  tactical  knowledge  available  for 
maximizing  information  throughput.  By  identifying  and  accounting  for  system  wide  knowledge, 
more  robust  and  effective  communication  is  realized  while  increasing  the  effective  throughput  of 
the  tactical  network.  Agents,  by  design,  are  background  network  processes  which  continuously 
work  to  identify  and  manage  tactical  network  knowledge  for  achieving  their  own  goal  of 
maximizing  effective  throughput. 

b.  Measures  of  Information,  e.g.  Entropy 

Claude  Shannon's  paper  in  the  40’s  established  a  mathematical  basis  for  the  theory  of 
commumcation  [56].  Shannon  defined  a  mathematical  function,  called  entropy,  for  measuring 
information  content.  Shannon's  entropy  function  is  defined  as 


22 


where  N  is  the  number  of  symbols  communicated,  q  is  the  number  of  possible  symbols,  and  p.  is 
the  probability  that  the  i  -  th  symbol  is  in  the  N  length  message.  As  noted  in  Hamming  [49],  "It 
is  important  to  realize  that  a  remark  like  'Consider  the  entropy  of  the  source'  can  have  no 
meaning  unless  a  model  of  the  source  is  included.  Your  estimate  of  the  entropy  of  a  source  of 
symbols  therefore  depends  on  the  model  you  adopt  of  the  structure  of  the  symbols.” 

A  variety  of  metrics  exist  for  defining  and  determining  information  content.  Kapur  [51, 
52]  provides  a  number  of  examples  and  references.  There  is  no  single  absolute  measure  of 
information.  Entropy  and  working  model  of  the  source  is  necessary.  A  model  is  needed  to 
specify  the  symbol  set  and  probabilities  for  the  given  symbols  for  all  points  in  time.  Usually,  the 
probability  distributions  are  assumed  to  be  “stationary.”  This  means  that  the  statistics  of  the 
symbols  do  not  change  with  time.  Operationally,  nonstationary  data  is  quite  common.  Thus, 
potential  performance  of  “optimal”  data  compression  schemes  such  as  Huffman  coding,  cannot 
be  realized.  Alternative  schemes,  such  as  Lempel-Ziv  dynamic  dictionary  based  approaches, 
often  demonstrate  better  operational  performance.  Thus,  there  is  no  one  ideal  technique  or 
underlying  model  for  a  given  coding  scheme. 

Ideally,  a  more  abstract  “context  dependent”  network  process  would  dynamically  identify 
and  select  the  appropriate  measures  of  information  and  their  most  appropriate  models.  Such 
metrics  and  models  can  then  be  selected  based  on  the  degree  of  compression  which  can  be 
operationally  realized  at  a  given  point  in  time.  While  managing  and  exploiting  other  types  of 
knowledge,  such  as  “system  design  knowledge”  and  “C2  knowledge,”  Agent  processes  can  also 
manage  “data  compression  knowledge.”  Thus,  improved  operational  performance  of  traditional 
data  compression  schemes  is  inherent  in  the  Agent  architecture. 

c.  Universal  Compression  and  Retrieval 
The  following  summary  note  is  fi-om  Krichevsky  [50]: 

The  output  of  a  source  may  be  compressed  up  to  its  entropy,  not  more.  It  is  the  main  fact 
of  the  soixrce  coding  theory,  which  has  its  origin  in  Shannon  (1948).  The  first  theoretical 
compressing  code  is  Shannon’s.  It  happened  to  be  very  close  to  Morse’s,  which  was 
developed  empirically  a  century  earlier.  Shannon’s  code  is  very  simple,  although  not 
optimal.  An  optimal  code  for  a  stochastic  source  was  constmcted  by  Huffman  (1952).  It 
may  be  used  to  compress  an  individual  word.  The  frequencies  play  the  role  of 
probabilities.  The  encoding  may  be  either  two-pass  or  one-pass.  In  the  first  case  the 
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frequencies  of  letters  are  counted  beforehand,  then  a  code  is  built.  In  the  second  case  the 
code  is  changed  along  with  the  word  reading. 

Output  words  of  Shannon  or  Huffman’s  codes  are  of  different  lengths.  There  is  a 
compressing  code,  whose  output  words  are  of  equal  length.  It  was  developed  by  first  G. 

L.  Khodak  (1969)  and  then  by  F.  Jelinek  and  F.  Schneider  (1972). 

A  decipherable  code  for  integers  is  constructed  by  V.  Levenstein  (1968)  and  P.  Elias 
(1975). 

Hansel  (1962)  and  Knchevski  (1963)  exploited  the  source  coding  to  lower-bound  the 
length  of  threshold  formulas. 

The  Kolmogorov  complexity  bridges  the  theory  of  algorithms  and  the  information 
theory.  Any  code,  including  Lempel-Ziv’s,  move  to  front,  etc.,  is  only  a  majorant  of 
Kolmogorov’s. 

In  other  words,  m^orants  of  Kolmogorov  codes  provide  a  theoretical  framework  for 
compression  algorithms.  In  this  context,  optimality  is  tied  to  computability,  as  well  as, 
compressibility.  Computing  cost  is  typically  a  critical  operational  parameter,  but  until  recently,  it 
has  not  been  an  integral  theoretical  component. 

Knchevsky  also  notes  that  “for  many  years  the  target  of  the  source  coding  theory  was  the 
estimation  of  the  maximal  degree  of  the  data  compression.  This  target  is  practically  hit  today. 
The  sought  degree  is  now  known  for  most  of  the  soiirces.  We  believe  that  the  next  target  must  be 
the  estimation  of  the  price  of  approaching  that  degree.  So,  we  are  concerned  with  the  trade-off 
between  complexity  and  quality  of  coding.”  The  reader  may  need  to  be  reminded  that  in  this 
theoretical  context,  the  sources  are  assiuned  to  be  known  and  well  behaved. 

Computing  time  is  a  critical  factor  for  agent  based  communication  links  but  until  recently 
it  has  not  been  a  theoretical  focus  of  concern.  Accurate  and  robust  source  models  are  another 
critical  operational  concern  that  is  often  overlooked  by  information  theorists.  Krichevsky’s 
analysis  assumes  that  the  sources  are  known  and  well  behaved.  Temporal  variability  is  not 
within  the  context  of  his  work. 

Within  its  own  scope  and  context,  coding  theory  provides  a  basis  for  determining 
compressability.  With  full  knowledge  of  their  utility  and  limits,  compression  algorithms  can  be 
identified  and  utilized  at  the  most  appropriate  times.  As  the  characteristics  of  data  sources 
change  with  different  tactical  situations,  software  agents  can  activate  the  most  appropriate 
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compression  algorithms  and  source  models  for  die  particular  context.  Agent’s  can  operate  on 
knowledge  within  and  beyond  the  scope  of  coding  theory  and  data  compression.  How  these 
bodies  of  knowledge  are  coordinated  is  of  particular  concern  for  optimizing  the  operational 
throughput  of  a  network. 

d.  Universal  Prediction,  e.g.  Machine  Learning,  Generalized  Approximation,  etc. 

Universal  prediction  is  another  recent  focus  in  coding  theory.  If  a  source  is  well  behaved 
and  can  be  modeled,  then  the  source  should  become  known  over  time  and  the  sequence  of 
symbols  should  be  optimally  predictable.  Theoretically,  if  the  symbols  can  be  predicted,  optimal 
coding  schemes  should  incorporate  such  predictability.  Traditionally,  predictability  is  not 
assumed.  For  adaptive  schemes,  lack  of  predictability  is  the  alternative  focus. 

Universal  predictive  coding  schemes  are  rooted  in  the  same  mathematics  as  related  areas, 
such  as  machine  learning,  generalized  approximation,  pattern  recognition,  classification,  and 
adaptive  filter  theory.  Probability  and  mathematical  statistics  are  typically  developed  and  applied 
using  the  munerical  methods  of  linear  algebra.  When  possible,  these  techniques  often  combine 
empirical  and  analytical  modeling  methodologies.  Analytical  models  are  preferred  over 
empirical  “black  box”  approaches. 

Just  as  the  Krichevsky  and  odiers  are  interested  in  bridging  complexity  theory  and  coding 
theory,  those  working  in  the  area  of  universal  prediction  and  interested  in  bridging  the 
mathematics  of  prediction  and  coding  theory.  The  Agent  approach  under  development  is  not 
limited  to  coding  theory,  or  those  areas  of  coding  theory  most  related  to  efficient  network 
communications.  As  previously  noted,  coding  theory  has  its  limitations  and  Agents  address  those 
limitations  vvliile  exploiting  opportunities  which  are  not  within  the  scope  of  traditional  coding 
theory  approaches. 

Coding,  complexity,  and  prediction  can  each  be  exploited  by  a  more  abstract  system 
process.  At  this  level  of  abstraction,  a  spectrum  of  competing  data  compression  algorithms  can 
be  evaluated.  This  can  be  done  alongside  competing  prediction  algorithms.  For  real  time 
execution,  algorithmic  complexity  is  a  critical  factor  for  both  coding  and  prediction.  The  Agent 
architecture  is  designed  to  manage  these  traditional  components,  but  these  plug-in  capabilities 
could  probably  be  managed  by  a  number  of  other  more  traditional  techniques.  The  ability  to 
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identify  and  quickly  utilize  system  wide  knowledge,  is  the  focus  of  agent  based  communication 
links,  i.e.  Agents.  The  agent  based  architecture  provides  the  mechanism  for  incorporating 
additional  bodies  of  knowledge  for  maximizing  network  throughput. 

Figure  1 1  illustrates  the  relationship  between  pattern  recognition  and  data  compression. 
In  both  cases,  invariances  are  of  special  interest.  The  goal  is  to  identify  functions  whereby 
predictable  and  recognizable  patterns  can  be  identified  and  exploited.  A  number  of  “plug-in” 
pattern  recognition  capabilities  have  recently  become  available.  Agents  are  being  designed  such 
that  those  capabilities  can  be  managed  and  exploited.  The  design  objective  is  to  demonstrate 
“coordination”  and  “organizational”  network  processes  that  manage  C2,  system  design,  data 
compression,  pattern  recognition,  and  otiier  bodies  of  knowledge  for  the  purpose  of  maximizing 
the  effective  throughput  of  tactical  communication  networks  currently  operating  in  the  Fleet. 
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Figure  1 1 

As  mentioned  earlier,  universal  predictive  coding  is  inherently  related  to  machine 
learning.  Intelligent  real-time  systems  share  a  similar  interest  in  machine  learning.  The  objective 
for  hierarchical  intelligent  systems  is  to  design  systems  such  that  they  can  learn  to  create  optimal 
tasks  and  coordinate  their  execution.  The  following  is  from  Lima  and  Saridis  [62]  and  discusses 
work  related  to  this  objective: 

A  robot  can  leam  from  the  data  provided  by  its  external  sensors  (such  as  cameras,  ultra¬ 
sound  transducers,  or  proximity  detectors)  or  internal  alarms  (such  as  a  battery  failure  or 
a  time-out  while  a  process  runs).  Often  the  goal  is  to  leam  how  to  recognize  a  scene  or  an 
object  in  the  scene,  by  either  a  statistical  or  a  stmctural  approach.  The  robot  explores  the 
similarities  of  the  scene  or  object  with  previously  stored  patterns.  Some  learning 
programs  record  the  strategy  used  to  solve  a  particular  problem  so  that  they  don’t  have  to 
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search  for  a  solution  when  the  problem  emerges  again  [Samuel  1963].  Other  programs, 
such  as  those  based  on  neural  networks,  begin  wiA  a  random  network  and  continually 
change  the  connections  (or  weights)  among  network  nodes,  to  reflect  a  bad  or  good 
performance  as  they  try  to  accomplish  their  job  [Hertz  1991].  This  later  type  of  learning 
algorithm  is  usually  classified  as  unsupervised  if  it  receives  no  information  about  the 
correctness  of  its  output,  and  as  supervised  if  the  goal  is  available.  We  can  improve  the 
algorithm’s  performance  by  measuring  the  error  between  its  goal  and  its  actual  output.  A 
third  category  is  reinforcement  learning,  where  limited  information  is  available  about  the 
algorithm’s  instantaneous  performance,  typically  in  the  form  of  success  or  failure  signals. 

Since  the  late  sixties,  various  strategies  based  on  reinforcement  learning  have  emerged  to 
address  the  control  of  complex  systems.  Reinforcement  learning  is  particularly 
interesting  for  robotics,  where  it  involves  the  exchange  of  small  bandwidth  information 
(failure  or  success)  between  robotic  subsystems.  In  typical  applications,  such  as 
unmanned  space  or  imderwater  missions,  the  cost  of  large  bandwidth  for 
communications  between  the  central  command  (earth  controller  or  main-vessel 
controller)  and  the  vehicle  is  prohibitive.  Designers  can  reduce  this  cost  by  increasing  the 
autonomy  of  the  machine  involved  in  the  mission. 

Fu  was  perhaps  the  first  to  write  about  learning  control  systems  and  to  define  intelligent 
control  systems  as  systems  of  an  interdisciplinaiy  nature  where  artificial  intelligence  and 
automatic  control  intersect  [Fu  1986].  Moreover,  he  introduced  the  concepts  of  stochastic 
automata  and  stochastic  grammars.  Narendra  and  his  associates  have  also  developed 
work  on  stochastic  automata  [Narendra  and  Thathachar  1989].  In  the  last  few  years, 

Sutton  and  his  associates  have  explored  reinforcement  learning  solutions  that  associate 
these  two  views  of  stochastic  automata  [Sutton  1988]. 

A  fiequent  limitation  of  reinforcement  learning  applications  to  robot  problem’s  is  the 
problem’s  large  state  space.  Lin  attempted  to  tackle  this  problem  by  providing  initial 
knowledge  to  the  robot  and  by  endowing  it  with  generalization  capabilities  via  neural 
nets  [Lin  1994].  Sutton  described  an  algorithm  that  learns  fi’om  both  virtual  experiences 
in  an  internal-world  model  and  real-world  experiences,  to  accelerate  the  learning  process 
[Sutton  1990].  Both  of  these  authors  used  Watkins’s  Q-leaming  algorithm,  which 
includes  a  learning-performance  function  [Watkins  and  Dayan  1992]. 

Finally,  Wang  and  Saridis  used  reinforcement  learning  to  improve  performance  at  the 
intermediate  level  of  the  hierarchy  [Wang  and  Saridis  1993].  And  Mclnroy  and  Saridis 
proposed  reliability  as  a  practical  measure  of  primitive-task  performance  -  but  did  not 
consider  the  computational  cost  [Mclnroy  and  Saridis  1994]. 

The  above  discussion  illustrates  that  neural  nets  are  but  one  technique  of  machine 
learning.  In  practice,  neural  nets  are  more  accurately  described  as  a  family  of  regression 
techniques  utilized  to  generate  empirical  models.  When  there  is  limited  communication 
bandwidth  between  agent  processes,  e.g.  mother  ship  and  vehicle,  agents  can  minimize 
communication  requirements.  For  purposes  of  the  Agent  architecture,  agents  with  synchronized 


27 


models  only  need  to  communicate  when  one  of  the  agents  recognize  a  deviation  jfrom  the  “real 
world,”  i.e.  part  of  its  environment  not  shared  with  the  other  agent.  Furthermore,  since  the  goal 
is  to  minimize  communication  requirements  between  such  agents,  synchronized  learning 
algorithms  are  another  body  of  knowledge  to  be  exploited. 
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Figure  12 


Figure  13 

A.  CODESIGN:  SOFTWARE  ENGINEERING  FOR  REAL-TIME  SYSTEMS 

Delays  in  communication  are  a  primary  concern  for  tactical  networks;  just  as 
transcontinental  phone  conversations  were  plagued  with  annoying  delays  due  to  the  limitations 
of  hardwired  signal  transmission.  The  addition  of  any  process  in  the  path  of  C2  messages  is  an 
even  greater  concern.  Because  Agents  map  messages  and  communications  to  more  efficient 
representations  and  transmission  timing,  they  inherently  introduce  delays  on  a  per  transmission 
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basis.  If  Agent  processes  are  introduces  at  the  1553B  bus,  very  small  latencies  may  be  required. 
This  may  be  a  significant  constraint.  If  the  Agent  processes  are  designed  into  the  CDLMS,  much 
flexibility  will  be  gained,  but  message  management  will  still  delay  message  communications. 
For  any  communications  network,  messages  are  typically  delayed  due  to  typical  management 
functions.  The  critical  concern  is  that  such  delays  be  minimal.  For  time  critical  data  compression 
applications,  data  compression  processors  (DCP)  are  typically  incorporated  into  the  system 
hardware.  This  is  a  “plug-in  capability”  that  our  agent-based  approach  can  manage  in  the  course 
of  minimizing  message  traffic  v^le  maximizing  effective  throughput.  Other  algoridim  specific 
application  processors  (ASIP’s)  are  commercially  available.  Agent’s  provide  an  opportunity  to 
utilize  those  off-the-shelf  plug-in  capabilities,  as  well  as. 

Several  domains  such  as  embedded,  real-time,  and  reactive  systems  are  the  application 
areas  for  which  hardware  /  software  codesign  techniques  are  most  beneficial.  They  are  beneficial 
because  die  increasing  complexity  of  advanced  systems  combined  with  technological 
advancement  requires  new  design  methods  and  integrated  tool  environments. 

Hardware  /  Software  codesign  is  different  from  conventional  approaches  in  that  it 
continuously  relates  the  hardware  development  cycle  to  the  software  development  cycle.  Hence, 
hardware  decisions  significantly  affect  software  design  activities  and  vice  versa.  In  codesign,  the 
entire  problem  is  treated  as  a  whole.  The  “co”  means  primarily  together.  However,  it  also 
expresses  a  design  flow  that  is  properly  coordinated;  a  joint  effort  among  designers  from 
different  areas.  The  effort  is  inherently  concurrent  in  that  the  majority  of  all  design  steps  are 
earned  out  in  parallel  by  a  team  that  guides,  coaches,  and  supervises  the  design  process.  Ideally, 
several  teams  of  experts  develop  system  components  rapidly  and  resolve  problems  in  a  timely 
manner. 
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Figure  15 
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Figure  17 


Interprocessor  Bus 
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Figure  18 


C.  SOFTWARE  REQUIREMENTS  -  A  FUNCTIONAL  DISECTION  LEADING  TO  A 
PROPOSED  DESIGN  FOR  IMPLEMENTATION 

•  Agent  will  not  be  specific  to  any  particular  digital  network,  but  will  be 

appropriate  for  any  digital  network  where  it  can  intercept  and  alter  messages  to 
and  from  all  nodes  on  the  network. 


33 


Agent  will  be  a  software  agent  in  structure. 

Agent  will  be  able  to  run  under  any  common  operating  system. 

Agent,  in  the  engineering  design,  does  not  require  any  particular  computer 
language  or  programming  style. 

Design  &  Architecture  must  support  modular  concepts  of  engineering  and  be 
adaptable  to  future  enhancement  /  expansion. 

The  design  of  Agent  should  be  as  general  as  possible  within  the  constraint  of 
performing  within  the  tactical  network  environment  and  Link- 16. 

The  software  and  design  should  be  readily  adaptable  to  major  link  component 
upgrades,  as  well  as  future  systems  and  technologies. 

Agent  control  should  be  distributed  rather  than  centralized. 

The  Agent  must  be  instantiated  on  every  node  in  the  link. 

The  Agent  must  not  require  a  special  or  central  node  for  control  or  any  other 
purpose. 

The  Agent  can  continue  to  operate  correctly  with  the  loss  of  a  number  of 
transmitters  or  receivers. 


Functions  &  Operation 


Agent  will  be  able  to  perform  all  known  heuristics  (e.g.,  delta  messaging,  update 
bundling,  extrapolated  updates,  and  so  forth),  and  be  extensible  to  other 
analogous  techniques  as  they  are  developed. 

Agent  must  decouple  its  processing  components  from  its  knowledge  of  link  rules 
and  operations,  so  that  a  simple  substitution  of  link  rules  and  operations  can 
enable  it  to  work  with  other  tactical  links  (e.g.,  Link-1 1,  Link-4A,  Link-22). 

Instantiations  of  Agent  will  be  able  to  communicate  with  each  other  in  order  to 
optimize  their  operations. 

Communications  between  instantiations  of  Agent  should  not  be  visible  to  host 
processing  systems  and  the  C2P  (JTIDS,  of  course,  will  be  aware  of  these 
transmissions). 

Inter-agent  communication  should  not  in  itself  constitute  a  significant  burden  to 
link  operations  (that  is,  should  consume  relatively  little  bandwidth  or  link 
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overhead). 


D.  FUNCTIONAL  REQUIREMENTS 


These  requirements  are  specific  to  Link- 16,  but  many  may  apply  to  other  digital 
networks. 

1 .  Agent  will  increase  the  effective  bandwidth  of  one  or  more  Link- 16  NPGs. 

a)  Agent  will  be  able  to  measure  the  message  loading  within  an  NPG. 

b)  Agent  will  be  able  to  detect  when  the  message  loading  reaches,  or  is  about  to 
reach,  saturation. 

c)  Agent  will  be  able  to  selectively  employ  an  heuristic  or  combination  of 
heuristics  to  reducing  the  loading  within  an  NPG  (and,  by  so  doing,  increasing 
the  effective  bandwidth). 

d)  Agent  will  rely  on  Time  Slot  Reallocation  (TSR)  to  distribute  the  additional 
effective  bandwidth  to  other  purposes,  including  RTR  messages. 

2.  No  “rules  of  the  link”  will  be  violated  by  Agent  operations. 

3.  Agent  operations  will  degrade  operations  within  an  NPG  to  the  minimum  extent 
necessary  to  prevent  or  delay  NPG  saturation. 

a)  Agent  will  employ  lossless  techniques  whenever  possible. 

b)  Agent  will  employ  lossy  techniques  only  \^^en  necessary  to  avoid  saturation. 

c)  Agent  will  explicitly  manage  NPG  degradation  due  to  its  operations. 

d)  Agent  will  employ  lossy  techniques  only  when  such  losses  are  operationally 
acceptable. 

4.  Agent  will  accommodate  all  current  and  planned  users  of  J-Series  information. 

5.  Agent  will  not  delay  the  transmission  of  J-Series  messages  beyond  the  point  of 
military  usefulness  to  the  receivers  within  the  tactical  context. 

6.  Agent  will  be  able  to  function  transparently  on  the  bus  that  leads  to  or  comes  from 
the  JTIDS  terminal  (when  implemented  in  a  JTIDS  environment). 

7.  Agent  shall  work  when  implemented  on  Link- 16  but  not  be  specific  to  Link- 16.  It 
should  readily  be  reconfigurable  to  operate  within  other  tactical  links. 
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8.  Agent  will  not  fail  or  degrade  if  one  or  more  nodes  unexpectedly  drop  off  the  link. 
There  will  be  no  main  or  central  node. 

9.  Agent  will  be  able  to  operate  successfully  in  an  environment  with  degraded 
connectivity  (that  is,  one  or  more  receivers  fail  to  receive  a  complete  message  stream, 
probably  due  to  loss  of  line  of  sight). 

10.  Agent  will  be  able  to  measure  its  own  effectiveness  and  dynamically  alter  its 
operations  in  response  to  those  measurements. 

1 1.  Under  no  circumstances  will  Agent  operations  cause  an  erroneous  J-Series  message 
to  be  received  at  the  host  component. 

12.  Agent  will  provide  a  complete  tactical  picture  within  militarily-acceptable  intervals, 
which  may  be  context  sensitive. 

a)  To  platforms  recently  entering  the  link. 

b)  To  passive  listeners. 
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KNOWLEDGE-BASED  COMPONENTS 


1.  General 

The  knowledge-based  components  for  Agent  are  especially  designed  for  Agent 
operations.  Mary  changes  from  the  usual  knowledge-based  paradigms  were  necessitated  by  the 
need  to  do  more  than  simply  recognize  situations,  but  also  to  perform  actions  in  response  to 
those  situations.  Therefore,  this  section  is  designed  to  describe  the  special  properties  of  the 
knowledge-based  components  so  that,  during  detailed  design,  appropriate  tools  can  be  properly 
designed  (e.g.,  translators  from  KIF  to  Agent  form,  translators  from  Agent  form  to  semantic 
networks,  and  the  inference  engine). 

2.  Semantic  Networks 

Facts  are  truth  assertions  used  either  to  create  or  edit  a  semantic  net,  or  provide  the  input 
to  inferencing.  They  are  also  used  by  the  metarule  frmctions.  It  is  assumed  that  the  reader  has  a 
general  knowledge  of  semantic  networks,  facts,  production  rules,  inference  engines,  and  other 
related  terms  used  in  artificial  intelligence. 

a.  The  Semantic  Network 

Underlying  the  facts  and  rules  of  Agent  is  the  concept  of  the  semantic  network.  This 
network  is  created  within  global  memory  available  to  any  of  the  processes  (and  processors)  of  a 
single  instance  of  Agent.  The  semantic  network  is  created  at  agent  initialization  by  the  use  of 
facts  with  an  expanded  grammar.  For  example, 

A  message  is_a  null_class 

The  value  facet  of  the  max_delay  slot  of  the  message  is  25  ms 

The  first  statement  creates  a  object  called  “message”  and  assigns  it  with  an  “is_a” 
relationship  to  the  null  class  or  object  (which  is  created  automatically  in  shared  memory).  The 
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second  statement  creates  a  slot  called  “max  delay”  within  the  message  object.  A  component  of 
the  initialization  process  creates  this  semantic  network  in  persistent  store  (using  IBM’s  ABE 
terminology). 

In  the  present  design,  this  network  cannot  be  added  to  during  agent  operations.  Although 
“is_a”  statements  during  initialization  create  classes,  “is_a”  statements  in  rule  consequents  create 
instantiations  (or  objects). 

The  mference  engine  “looks  up”  values  in  the  semantic  net  vdien  antecedents  reference 
slots  in  the  semantic  network,  and  “sets”  values  in  the  semantic  net  when  consequents  fire. 


Figure  19,  Agent  Semantic  Network 


b.  Slots  and  Objects 


( 1 )  NULL  slots  and  the  NULL  object. 

A  special  object  is  always  present  at  the  top  of  the  semantic  network,  the  null  fi^me  (or  null 
class  or  null  object).  All  classes  and  instantiations  are  subclasses  of  the  null  frame.  It  has  many 
uses. 

It  is  awkward  to  always  have  to  explicitly  refer  to  a  slot  reference  in  the  rules: 
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The  <slot  name>  of  the  <object  name>  is  <value> 

To  simplify  where  possible,  the  <object  name>  always  defaults  to  the  null  object.  For 

example. 

The  rules  below  use  this  construction  often: 

IF  Agent  is  operating 

This  usage  refers  to  the  “Agent”  slot  of  the  null  object,  whose  value  might  be 
“operating.”  On  the  other  hand,  “The  mode  of  Agent  is  operating”  refers  to  the  mode  slot  of  the 
Agent  object. 


(2)  Slot  References 
A  slot  reference  is  of  the  following  formats: 

<fi‘ame> 

<slot>  [<fi‘ame>] 

<slot>  [of  ANY  <fi'ame>] 

<slot>  [in  ANY  <frame>] 

[THAT]  <fi^e> 

[THOSE]  <frame> 

If  the  name  of  the  slot  is  omitted,  then  the  default  slot  of  the  named  frame  is  referenced. 
If  the  name  of  the  frame  is  omitted,  ftien  the  null  object  is  assumed.  So  the  following  are  slot 
references: 


1.  The  door 

2.  The  door  of  the  house 

3.  The  door  of  ANY  house 

4.  THAT  I  THOSE  door 

In  the  first  case,  since  the  name  is  omitted,  the  slot  is  part  of  the  null  object.  In  the  second 
reference,  the  slot  is  part  of  the  house  frame.  If  both  are  used  they  reference  different  values.  In 
the  third  form,  the  slot  reference  is  to  the  set  of  all  slots  of  all  instantiated  houses.  In  ftie  last 
form,  wliich  is  always  paired  with  one  or  more  ANY  constructions,  the  reference  is  to  all  slots 
referred  to  by  the  matching  ANY  constructions. 

(3)  Dynamic  object  and  slot  creation 

Note  that  these  constructions  do  not  create  slots  or  objects  in  antecedents,  but  do  create 
slots  and  objects  in  consequents.  If  there  has  been  no  statement  such  as 

THEN  Agent  is  operating 
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there  is  no  “Agent”  slot  in  the  null  object  when 

IF  Agent  is  operating 

is  encountered  by  the  inference  engine.  Therefore  the  test  fails  and  the  slot  is  not  created. 
(However,  the  slot  could  have  been  predefined  and  initialized  during  Agent  initialization — ^the 
point  is  that  it  doesn’t  have  to  be.)  This  kind  of  dynamic  object  and  slot  creation  makes  it  much 
easier  to  write  rules  where  perishable  knowledge  is  involved,  and,  in  fact,  is  the  preferred  way  of 
writing  such  a  rule. 

F.  FACTS 


1.  General  Forms 


Facts  in  Agent  are  references  to  a  semantic  network.  Facts  consists  of  the  following 

forms; 

<slot  >  [of  <fi‘ame>]  <declarative  operation>  <value> 

<slot  >  [of  <ffame>]  <relationship>  <fi:ame  reference> 

[<facet  >]of  <slot  >  [<frame>]  <declarative  operation>  <value> 

The  <ffame>  refers  to  the  class  or  object  itself,  the  <slot  >  is  the  name  of  a  slot  within 

that  fi’ame.  The  <facet>  refers  to  a  facet  within  a  slot.  Items  within  square  brackets  are 

optional  when  omitted,  the  reference  defaults  to  the  null  object.  Facet  references  are  only  used 

in  building  the  semantic  network,  which  takes  place  at  Agent  initialization  time. 

Sample  declarative  operation: 

is 


Sample  relationships: 

is_a 
has  a 


Below  are  a  set  of  sample  facts,  with  their  forms  in  parentheses: 

The  default_facet  of  the  weight  slot  of  the  airplane  frame  is  32,000  lbs 
The  house  is  green 
A  house  is_a  building 
A  building  has_a  door 


(3) 

(1) 

(2) 

(2) 
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Note  that  there  are  a  number  of  words  used  for  readability  that  are  completely  ignored  by 
Agent,  such  as  “the”  and  “a.” 

In  a  later  section  of  this  report,  the  use  of  facts  in  rules  is  explained  and  differences  in 
syntax  and  semantics  are  noted.  This  section  does  not  explain  how  the  various  forms  of  facts  are 

used.  It  is  often  helpful  to  have  plural  forms  of  slot  or  fi’ame  names.  When  defining  a  semantic 

net,  for  example,  the  following  form  can  be  used; 

The  house(s)  is_a  building(s) 

This  creates  a  house  frame  with  a  synonym  for  house  being  houses.  There  is  no  meaning 
associated  with  plural  forms — ^they  are  used  precisely  as  singular  forms. 

2.  FactSets 

FactSets  are  collections  of  facts  referenced  by  name.  See  under  MetaLanguage. 

G.  PRODUCTION  RULES 

1.  General  Forms — ^Antecedents  and  Consequents 

The  general  forms  of  Agent  production  rules  are  as  follows: 

1-  <slot  reference>  <operation>  (<value>  [<units>]  )  [ONLY  |  ALSO] 

2.  <slot  reference>  <comparison>  <value  [<units>] )  [ONLY  |  ALSO] 

<slot  reference>  <comparison>  <slot  reference>  [ONLY  |  ALSO] 
<directive>  <slot  reference>  |  <frame  reference> 

2.  Comparisons 

The  following  comparisons  are  defined  in  Agent: 

is  -  a  positive  statement  of  truth 
isn’t  -  a  negative  statement  of  truth 
is_greater_than  -  > 
is_greater_than_or_equal_to  -  >= 
is  less  than  -  < 
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is_less_than_or_equal_to  -  <= 
is_equal_to  -  numeric  equality 
is_not  -  logical  negatation 
is_identical_to  -  non-numeric  equivalence 

is_the_same_as  -  non-numeric  equivalence,  less  forceful  than  equality 
is_different_from  -  non-numeric  non-equivalence,  less  forceful  than  is_not 

These  all  have  meanings  which  are  applied  on  a  concete,  and  abstract  formulation  of 
comparisons. 


3.  Antecedent  format 


An  antecedent  appears  in  the  following  format: 

1 .  <slot  reference>  <comparison>  <value>  |  <slot  reference> 

2.  There  is  <object  > 

The  following  are  examples  of  antecedents  of  the  first  form: 

IF  The  color  of  the  house  is  green 

The  color  of  the  house  is  the  same  as  the  color  of  the  bam 
The  mode  is  delta_messaging 
THAT  message  is_a  J3,2 

These  antecedents,  when  referenced,  find  the  appropriate  slot  reference,  perform  the 
comparison,  and  return  a  tmth  value.  It  is  important  to  note  that  diey  change  nothing.  In  the  last 
antecedent  shown  above,  the  “is_a”  checks  to  see  if  any  message  signified  by  the  THAT 
construction  is  instantiated  as  a  J3.2  message  (or  instantiated  from  one  of  its  subclasses).  An 
object  can  have  an  “is_a”  relationship  to  any  number  of  classes. 

Each  antecedent  is  implicitly  connected  by  logical  conjunction.  However,  an  OR 
construction  can  be  used  ^en  parentheses  are  added: 

IF  (The  color  of  the  house  is  green  OR 

The  color  of  the  house  is  red) 

The  color  of  the  house  is  the  same  as  the  color  of  the  bam 
The  mode  is  delta_messaging 

This  form,  when  compiled,  results  in  two  separate  rules  with  no  OR  constmction. 

Antecedents  of  the  second  form  are  special.  The  parser,  upon  seeing  “There  is”  beginning 
an  antecedent,  checks  to  see  if  there  have  been  any  instantiations  of  the  object  references,  and 
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returns  TRUE  if  there  have  been,  FALSE  otherwise.  In  addition,  there  is  an  implicit  ANY 
involved,  in  that  subsequent  uses  of  THAT  will  refer  to  the  instantiated  objects. 


4.  Consequents 


<slot  reference>  <operation>  <slot  reference>  |  (<value>  [<units>]) 

The  operations  in  consequents  change  the  values  of  slots  or  create  new  relationships.  The 

defined  operations  are  as  follows: 

is 

is_a 

hasa 

Consequents  are  executed  in  the  order  given. 


5.  Sample  Complete  Rule 


IF  (The  color  of  die  house  is  green  OR 

The  color  of  the  house  is  red) 

The  color  of  die  house  is_the_same_as  die  color  of  the  bam 
THEN  The  house  is  desirable 

The  price  of  the  house  is  unknown  ONLY 

This  rule  is  provided  to  illustrate  many  of  the  bad  things  one  can  write  in  rules.  For 

example,  no  specific  house  is  referred  to.  Therefore  they  will  fail  since  the  do  not  refer  to 

instantiations.  The  rule  should  have  been  written  as  follows: 

IF  There  is  a  house 

There  is  a  bam 

(The  color  of  THAT  house  is  green  OR 
The  color  of  THAT  house  is  red) 

The  color  of  THAT  house  is_the_same_as  the  color  of  the  bam 
THEN  The  house  is  desirable 

The  price  of  the  house  is  unknown  ONLY 

In  this  version  of  the  rule,  the  consequents  are  vague.  Since,  in  the  first  consequent,  we 
refer  not  to  “THAT  house”  but,  simply,  “house,”  the  value  “desirable”  is  concatenated  (see 
below)  with  other  values  in  the  default  slot  of  the  house  frame,  if  there  is  one.  Since  this  is  a 
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modification  to  declarative  knowledge,  all  houses  would  default  to  “desirable”  as  a  result. 
Similarly  in  the  second  consequent.  Here’s  another  try: 

IF  There  is  a  house 

There  is  a  bam 

(The  color  of  THAT  house  is  green  OR 
The  color  of  THAT  house  is  red) 

The  color  of  THAT  house  is_the_same_as  the  color  of  bam 

THEN  The  appeal  of  THAT  house  is  desirable 

The  price  of  THAT  house  is  interesting  ONLY 

Note  that  the  first  two  antecedents  identify  the  set  of  instantiated  houses  and  instantiated 
bams.  But  the  “color  of  the  bam”  reference  will  probably  cause  a  problem  since  what  we  are 
probably  interested  in  is  the  set  of  houses  that  have  bams  of  the  same  color.  So,  finally,  here  is 
the  form  that  seems  correct: 

IF  There  is  a  house 

THAT  house  has  a  bam 

(The  color  of  THAT  house  is  green  OR 

The  color  of  THAT  house  is  red) 

The  color  of  the  bam  of  THAT  house  is_the_same_as  the  color  of 
THAT  house" 

THEN  The  appeal  of  THAT  house  is  desirable 

The  price  of  THAT  house  is  interesting  ONLY 

Note  that  “has_a”  relationships  amount  to  a  special  type  of  slot  reference  (special  in  that 
all  of  the  slots  and  other  linkages  of  the  bam  frame  are  now  part  of  the  house  fi-ame). 


H.  CONCATENATION  IN  THE  RULES 

Multiple  values  can  be  assigned  to  the  same  slot  simultaneously. 

TFEEN  The  house  is  green 

does  not  refer  to  any  house  in  particular  (it  isn’t  “THAT  house  is  green”)  and  there  is  no 
object  reference.  Therefore  a  slot  is  created  in  the  null  object  called  “house”  and  its  value  is 
assigned  to  be  “green”.  (Slots  are  automatically  created  when  referenced — they  do  not  all  have 
to  be  predefined  in  the  semantic  net  creation  step  of  agent  initialization.  They  are  never 
removed.) 

’  Two  uses  of  THAT  in  the  same  antecedent  cause  a  pair-wise  comparison. 
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THEN 


The  house  is  green 
The  house  is  big 


The  above  concatenates  two  values  in  the  house  slot  of  the  null  object,  “green”  and  “big.” 
Therefore, 


IF  The  house  is  green 

succeeds,  because  “green”  is  one  of  the  slot  values. 

IF  X 

THEN  The  track  of  that  message  is  xxxxx 

The  track  of  that  message  is  yyyyy 


In  this  construction,  the  message  referred  to  as  “that”  message  now  carries  both  track 
IDs.  This  is  because  die  slots  of  the  object^  concatenate  values  assigned  to  them  rather  than 
replacing  them  by  default.  A  query  as  to  the  track  ID  will  match  as  long  as  one  of  the 
concatenated  values  match. 

If  it  is  desired  that  only  one  value  be  present  in  a  slot,  there  is  a  directive  for  that  in  the 
production  grammar;  ONLY.  It  looks  like  this: 

IF  X 

THEN  The  track  of  that  message  is  xxxxx 

The  track  of  that  message  is  yyyyy  ONLY 


Of  course,  the  assignment  of  xxxxx  wouldn’t  actually  be  in  the  real  rule  if  ONLY  was 
meant.  When  a  consequent  ends  in  ONLY  then  all  concatenations  are  removed  and  the  single 
value  is  assigned  to  the  slot. 

The  temporary  message  is  where  all  operating  processes/processors  assemble  a  batched 
message.  There  needs  to  be  only  one  of  these,  as  each  process/processor  will  contribute  to  a 
single  output  message.  They  only  need  to  lock  that  message  while  they  add  to  it.  Also,  if  the 
message  is  long  enough,  or  the  oldest  iq>date  has  aged  enough,  the  message  becomes  an  output 
message  and  is  deinstantiated  as  a  temporary  message.  Any  process  with  the  authority  of  adding 
to  the  temporary  message  can  make  this  switch.  Also,  this  is  how  the  exception  handler  outputs  a 
message  when  it  senses  and  exception  condition. 


^  An  “object”  can  either  be  a  class  (frame)  or  an  instantiation  of  a  class  (frame)  in  this  document. 
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ANY/THAT/THOSE  CONSTRUCTIONS 


1.  General 


When  ANY  appears  in  an  antecedent,  the  inference  engine  creates  a  list  of  all  objects  that 
satisfy  the  specified  conditions  (if  any).  Thus, 

IF  The  status  of  ANY  message  is  late 

will  create  a  list  of  the  internal  identifiers  of  all  late  messages.  The  THAT  (or  THOSE) 

construction  then  refers  to  all  items  in  that  list.  Therefore, 

IF  The  status  of  ANY  message  is  late 

THEN  The  status  of  THAT  message  is  output 

changes  the  status  of  every  instantiation  of  message  with  “late”  status  to  “output”  status. 

If  there  are  no  objects  (instantiations),  then  ANY  fails. 


2.  Subsets 


IF  The  status  of  ANY  message  is  late 

The  type  of  ANY  of  THOSE  message  is  video 
The  time  of  ANY  of  THOSE  message  is  today 
RULE  THOSE  messages  are  no  good 

In  this  instance,  the  THOSE  in  the  consequent  refers  only  to  “late  video  messages 
generated  today.”  In  this  construction,  the  antecedents  have  order  (each  subsequent  ANY  creates 
a  subset  of  the  previous  ANY).  However,  in  the  consequent,  only  the  smallest  subset  is  referred 
to.  This  is  the  only  instance  in  the  grammar  where  the  antecedents  must  be  ordered.  Therefore  it 
may  take  several  rules  to  inference  properly. 
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3. 


Evaluation  Order 


A  slot  has  one  or  more  facets.  Every  slot  has  the  value  facet,  which,  unless  initialized 
when  the  semantic  net  is  initialized,  is  initially  empty.  However,  the  convention  in  Agent  is  that 
there  are  two  other  facets  in  every  slot:  the  default  slot  and  the  if  needed  slot. 

The  default  facet  contains  a  value  that  is  used  if  tire  value  facet  is  empty.  In  general,  rule 
bases  to  do  alter  the  default  facet.  There  is  a  value  in  the  value  facet  and  a  rule  causes  that  value 
to  become  empty,  the  inference  engine  will  use  the  default  value  at  its  next  opportunity,  if  there 
is  a  default  value. 

Finally,  an  “if  needed”  function  belongs  to  the  third  standard  facet.  If  the  first  two  facets 
are  empty,  and  there  is  a  function  in  the  if  needed  facet,  that  function  will  return  a  value.  So 
when  referencing  a  slot,  the  following  order  is  used: 

1.  value 

2.  default 

3.  if  needed  function 

If  the  rules  writer  knows  that  the  if  needed  function  need  only  be  called  once,  the 
following  construct  can  be  used: 

The  temporary  value  is  the  cost  of  THAT  message 

\\diere  the  “cost”  is  calculated  with  an  if  needed  function.  Then  “temporary_value”  can 
be  used  until  the  cost  needs  to  be  recalculated.  Using  if  needed  functions  is  best  when  the  value 
returned  must  be  measured  fi'om  a  constantly  changing  world  model. 

IF  The  distance_fi‘om_landing  of  the  aircraft  is  greater  than  20  miles 

In  this  case,  each  time  the  distance_fi‘om_landing  slot  is  accessed,  the  if  needed  fimction 
provides  the  current  answer. 
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J.  DIRECTIVES 

Directives  are  special  words  which  perform  special  actions  in  consequents  of  rules.  They 
have  a  different  s>utax  that  ordinary  consequents.  Examples  are  DEINST ANTIATE,  LOCK 
UNLOCK,  MOVE,  INFER,  etc. 

IF  ANY  message  is  late 

THEN  DEINSTANTIATE  THAT  message  FROM  <frame> 

1.  DEINSTANTIATE 

DEINSTANTIATE  <object>  [FROM  <ffame>]  performs  the  opposite  action  of  “is  a”  in 
a  rule  consequent.  Instead  of  creating  an  instance  or  object,  it  deletes  it.  I  know  of  no  standard 
inference  engine  which  allows  deinstantiation,  but  we  have  to  have  it  in  order  to  get  rid  of 
messages  that  no  longer  have  any  value  to  Agent  processing. 

The  part  of  the  consequent  that  follows  the  DEINSTANTIATE  is  parsed  according  to  the 
normal  grammar.  So  that,  in  the  above  case,  “THAT  message”  refers  to  the  subset  created  by  the 
antecedent  use  of  ANY. 

If  no  FROM  clause  appears,  the  object  is  removed  from  all  of  its  is_a  links.  If  a  FROM 
clause  appears,  the  object  removed  only  from  the  listed  frame.  Thus  an  object,  such  as  a 
message,  can  be  instantiated  in  a  temporary  manner  to  a  class,  instantiated  to  one  or  more 
additional  classes,  and  then  removed  from  the  instantiation  list  of  the  original  “is_a”  assignment. 


2.  LOCKAJNLOCK 

LOCK  <shared  memory>  |  <class>  |  <object>  |  <variable> 
prevents  all  access  to  a  sub-tree  within  shared  memory,  or  to  a  named  variable.  Although 

LOCK  can  apply  to  any  sub-tree,  it  generally  applies  to  the  whole  of  shared  memory  (which  is  a 

sub-tree  of  the  null  object)  or  to  the  instantiations  of  one  or  more  messages.  When  other 

processes  use  a  construction  that  accesses  or  changes  a  locked  sub-tree,  they  can  either  hang 
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until  unlock  or  fail.  Hanging  until  unlock  is  easier  to  handle  and  understand  than  failure,  so  the 
design  will  cause  the  other  processes  to  pause  until  unlock. 

One  tricky  part  of  LOCK/UNLOCK  not  shown  in  the  rules  below  is  that  after  the  lock 
succeeds  the  rule  has  to  be  repeated  because  die  lock  of  some  other  process  could  have 
succeeded  before  any  given  lock  takes  place.  Thus  the  conditions  that  prompted  the  lock  could 
no  longer  apply.  Thus,  if  I  locked  an  aged  entry  message,  I  could  very  well  find  out  that  some 
other  process  had  marked  it  for  encoding  (so  it  was  no  longer  an  entry  message).  In  practice  that 
means  that  those  messages  identified  by  the  ANY  in  an  antecedent  are  no  longer  part  of  the 
THAT/THOSE  of  the  consequents  after  locking.  Which  is  why,  after  locking,  the  rule  has  to  be 
repeated.  These  repeats  are  not  shown  in  the  rule  sets  developed  for  the  engineering  design  for 
the  sake  of  simplicity,  but  will  be  part  of  the  detailed  design. 


3.  NUMBEROF 


NUMBEROF  <fi-ame>  returns  the  number  of  instantiations  (not  classes)  associated  with 
that  frame  or  any  of  its  decendents.  Thus 
NUMBEROF  messages 

returns  all  of  the  messages  that  have  been  instantiated  in  the  semantic  network  below  the 
*inessage”  frame. 

NUMBEROF  THOSE  messages 

will  return  the  number  of  message  as  subsetted  by  previous  ANY  clauses. 


4.  NAMEOF 


NAMEOF  is  used  to  return  the  name(s)  of  instantiated  object(s).  There  are  times  vsdien  it 
is  important  to  refer  to  specific  instantiations  whose  names  may  have  been  assigned  and  not 
stored. 


NAMEOF  THAT  message 

returns  the  true  message  name.  NAMEOF  is  generally  useful  in  conjunction  with 
variables,  as  in 


name  is  NAMEOF  THAT  message 
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The  status  of  $name  is  empty 


If  NAMEOF  matches  multiple  names,  then  all  are  returned. 

5.  INFER 

A  rule  base  can  initiate  inferencing  on  another  rule  base,  pausing  until  the  inference 
engine  concludes.  This  not  only  makes  the  rules  easier  to  read,  but  also  eliminates  inferencing 
when  it  isn  t  needed.  When  INFER  is  completed,  the  facts  instantiated  by  the  call  become  part  of 
the  facts  available  to  subsequent  rules  in  the  calling  knowledge  base.  It  looks  like  this: 

IF  X 

THEN  INFER  knowledge-base 

It  is  assumed  that  the  facts  needed  for  the  named  knowledge  base  are  the  ones  available 
to  the  calling  data  base  (although  the  named  knowledge  base  can  trigger  a  function  that  generates 
additional  facts,  if  it  needs  to).  The  resulting  facts  simply  become  available  to  subsequent  rules 

and  are  returned  to  the  calling  base  (or  to  the  metarule  level)  as  the  results  of  the  inferencing 
process. 

6.  PARALLEL 

The  PARALLEL  directive  allows  certain  rules  to  fire  concurrently  with  other  rules  if  the 
system  has  multiple  processors  available  to  it.  The  use  of  PARALLEL  is  discussed  in  the  section 
below  concerning  automatic  rule  sorting. 

K.  SPECIAL  TERMS 

There  are  other  terms,  such  as  NULL,  MINUS,  TIME/  and  FIELD  that  are  like 
directives  except  that  they  are  part  of  the  normal  rule  syntax. 
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1. 


NULL 


NULL  is  used  in  facts  and  rules  to  erase  any  values  assigned  to  a  slot. 

The  color  of  the  house  is  NULL  ONLY 

resets  the  value  to  the  empty  set.  This  usage  is  completely  different  and  distinct  from  the 
null  class  to  which  all  objects  and  instantiations  are  related.  In  general,  if  NULL  follows  “is_a,” 
it  refers  to  the  null  frame.  In  all  other  forms  it  refers  to  an  empty  value. 

Implementation  is  automatic  in  that  if  no  value  is  assigned  to  a  slot  called  “null”  in  the 
null  frame,  the  result  will  be  to  return  a  null  value.  Expressions  that  would  set  a  value  into  a  slot 
called  “null”  are  disallowed. 


2.  MINUS/PLUS/DIVroED_BY  (Slot  Arithmetic) 


For  example,  in  the  construction, 

IF  The  status  of  ANY  message  is  entry** 

The  TIME/  minus  the  time  of  THAT  message  is _greater_than  the 
message_processing_time_limit 

a  slot  reference  appears  on  either  side  and  a  numeric  value  of  the  slot  is  expected.  If  the 

values  in  the  slots  are  not  numeric  the  antecedent  simply  fails.  If  they  are  numeric,  then 

subtraction  takes  place  and  a  value  results .  This  value  can  be  stored  explicitly,  as  follows: 

The  TIME/  minus  the  time  of  THAT  message  is  the 
delay_time 

This  expression  puts  the  difference  into  the  delay_time  slot. 

The  idea  works  for  other  embedded  arithmetic  operations  on  slots.  There  is  however  a 
different  form  of  arithmetic  in  the  rules,  which  is  described  below. 


3.  FIELD 


FIELD  (source  or  destination  string,  starting  position,  number  of  characters) 


*  These  rules  cover  the  problem  of  an  entry  message  (left  or  right)  that  has  sat  too  long  without  being  processed 
(encoded  or  decoded). 
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FIELD  represents  a  substring  delimited  by  a  starting  position  and  a  number  of  characters. 
The  source  can  be  an  input  buffer  or  a  slot  value.  The  starting  position  starts  at  1.  If  the  number 
of  characters  field  is  set  to  zero,  then  the  all  available  characters  from  the  starting  position  to  die 
end  are  matched  and  the  number  of  such  characters  is  returned  in  the  third  parameter.  If  the 
number  of  characters  is  set  to  a  positive  value,  that  number  of  characters  is  matched.  Thus 
NCHARS  =  0 

string  of  message  is  FIELD  (left_input_buffer,l,nchars) 

transfers  the  entire  contents  of  the  input  buffer  to  the  string  slot  of  the  message  frame, 

and  returns  the  number  of  such  characters  to  the  nchars  parameter. 

In  Agent  initialization,  the  following  statements  might  appear: 

A  messageformat  is_a  NULLCLASS 
A  J3.2  is_a  message_format 
The  track-position  of  a  J3.2  =  is  14 
The  track-length  of  a  J3.2  is  22  characters 

This  declarative  knowledge,  stored  in  KIF  format,  is  persistent  knowledge.  That  is,  it  is 
not  normally  changed  by  consequents  of  rules  as  they  are  fired  by  the  inference  engine.  They  are 
usually  part  of  the  invariant  part  of  the  semantic  net  in  shared  memory.  (The  inference  engine 
has  the  capability  of  dynamically  changing  persistent  knowledge,  which  means  that  it  is  capable 
of  learning,  although  Agent  does  not  employ  this  feature.) 

In  this  way,  with  the  iise  of  field,  any  message  can  be  decoded  from  its  character  string 
format  (raw  format)  to  a  set  of  slot  values  within  an  instantiated  object.  The  knowledge  of  how 
to  do  this  is  external  to  the  agent,  so  that  the  agent  can  operate  on  any  set  of  messages  without 
changing  its  internals.  The  only  assumption  is  that  the  message  is  in  string  format  and  die  field 
positions  are  fixed.  However,  a  version  of  Agent  can  be  built  that  can  deal  with  variable  format 
messages  as  well  as  long  as  sufficient  information  is  present  in  the  message  to  be  able  to 
determine  field  starting  piositions  (and,  possibly,  lengths). 

4.  NCHARS 

NCHARS,  which  takes  no  arguments,  returns  the  number  of  characters  in  the  left  or  right 
input  buffer. 
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L. 


VALUE  ARITHMETIC 


Simple  arithmetic  is  allowed  when  setting  slot  values.  For  example,  sometimes  a  counter 
needs  to  be  incremented.  For  example, 

THEN  The  time  of  the  message  is  the  time  of  the  message  +  1 

takes  the  time  of  the  message,  adds  one  to  it,  and  stores  it  back  in  the  time  slot.  However, 

in  this  case  the  default  is  ONLY.  There  is  another  directive,  called  ALSO,  which  performs  slot 

concatenation.  This  can  be  rather  interesting  if  misused.  If  I  write 

THEN  The  time  of  the  message  is  the  time  of  the  message  +  1 

The  time  of  the  message  is  23  hrs* 

Then  I  will  have  a  single  value  for  the  time  of  the  message,  23  hrs,  because  the  parser 

interpreted  these  consequents  as  follows: 

THEN  The  time  of  the  message  is  the  time  of  the  message  +  1  ONLY 

The  time  of  the  message  is  23  hrs*  ONLY 

The  second  use  replaced  the  first.  If  I  had  written 

THEN  The  time  of  the  message  is  22  hrs  ONLY 

The  time  of  the  message  is  23  hrs  +  1  ALSO 

then 

IF  The  time  of  the  message  is  23  hrs 

The  time  of  the  message  is  23  hrs  +  1 

would  succeed!  Recall  that  in  non-numeric  value  assignments  the  grammar  defaults  to 
ALSO. 

A  special  but  important  variation  of  value  arithmetic  takes  the  following  forms: 

<slot>  =  <slot>  <arithmetic  operator>  <value>  |  <slot> 

<slot>  =  <arithmetic  expression> 

The  following  are  examples  of  this  form  of  arithmetic: 

C  =  C+  1 


*  The  units  after  a  value  are  stored  but  ignored.  If  the  right-hand  side  of  a  consequent  is  can  be  interpreted  as  a 
numeric  operation,  it  will  be.  Any  characters  after  the  numeric  are  considered  to  be  something  like  units,  stored 
but  unevaluated. 

*  The  units  after  a  value  are  stored  but  ignored.  If  the  right-hand  side  of  a  consequent  is  can  be  interpreted  as  a 
numeric  operation,  it  will  be.  Any  characters  after  the  numeric  are  considered  to  be  something  like  units,  stored 
but  unevaluated. 
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C=  23.5/1 


Thus  counters  can  be  employed  as  needed.  Note  that  the  slot  reference  is  in  the  null 
object  or  frame,  and  that  ONLY  is  implied.  As  written,  these  counters  are  global. 

M.  CONCATENATION  IN  NAMES 

The  use  of  square  brackets  denotes  concatenation.  In  Agent,  concatenation  is  used  to 
produce  an  unique  identifier  for  an  object.  Thus, 
n  =n  +  1 

message[n]  is_a  update 

increments  the  counter,  concatenates  the  value  of  that  counter  to  the  string  “message,” 
and  instantiates  the  object  under  the  concatenated  name.  Tins  is  more  of  a  bookkeeping  facility 
than  a  necessary  one,  in  that  one  could  design  the  semantic  network  to  have  multiple  objects  of 
identical  names,  but  it  results  in  a  difficult  design  with  no  advantage.  Once  the  message  has  been 
mstantiated  as  message[n],  other  rule  sets  will  pick  it  up  or  ignore  it  on  the  basis  of  the  values  in 
its  slots  rather  than  by  its  name. 

N.  VARIABLES,  POINTERS,  AND  INDIRECTION 


Although  the  use  of  slots  in  the  null  frame  is  rather  helpful,  coordinating  asynchronous 

processes  requires  some  kind  of  local  variables  in  the  rules.  For  example,  in  the  example  in  the 

section  above,  n  is  a  slot  of  the  null  frame.  However,  if  two  identical  processes  are  operating, 

they  will  not  be  able  to  use  this  mechanism  easily.  Therefore  any  identifier  that  begins  with  an 

ampersand  becomes  a  local  variable  available  only  to  the  rule  base  in  which  it  appears. 

&n  =  &n  +  1 
message[&n]  is_a  update 

In  this  case,  local  space,  space  not  in  global  shared  memory,  is  allocated  for  n,  and  that 
allocation  is  only  available  within  the  scope  of  the  process  that  defines  it.  Within  the  operations 
of  that  process,  n  is  global.  That  is,  it  retains  its  value  once  assigned.  In  some  sense  it  is  a 
permanent  variable  outside  of  the  scope  of  the  semantic  network. 
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Any  structure  can  be  stored  in  such  a  variable,  including  messages.  The  inference  engine 
evaluates  the  variable  to  a  structure  or  a  value  and  substitutes  that  structure  or  value  in  the  rules. 

If,  however,  I  assign  a  complex  structure,  such  as  a  message,  to  a  variable,  a  copy  of  the  original 
is  created.  The  original  itself  is  untouched. 

The  pound  sign  is  used  for  pointer  variables.  One  can  write,  for  example, 

#n  is  message[n] 

In  this  case  the  pointer  refers  to  the  original  message  and  not  to  a  copy  of  it. 

The  dollar  sign  (“$”)  is  used  to  indicate  indirection.  For  example,  if  I  use  a  slot  in  the 
null  frame  to  store  the  name  of  an  object  I  have  no  way  of  getting  to  the  contents  of  that  object. 

THEN  n  is  message[m] 

The  status  of  n  is  idle 

The  first  use  of  n  is  as  the  “n”  slot  of  the  null  frame.  The  problem  here  is  that  in  the 

second  line  “n”  is  meant  to  be  the  value  of  the  n  slot  of  the  null  fi^e  (which  is  a  message).  A 

slot  cannot  have  a  slot.  Therefore,  to  indicate  that  I  want  n  to  be  evaluated  before  the  rest  of  the 

expression,  I  use  a  dollar  sign: 

THEN  n  is  message[m] 

The  status  of  $n  is  idle 

The  inference  engine  effectively  substitutes  “message[m]”  for  “n”  in  this  case,  since 
“message[m]”  is  the  value  of  n. 

O.  REASONING  WITH  UNCERTAINTY 

Although  there  are  many  forms  of  reasoning  with  uncertainty  that  can  be  explicitly  added 
to  the  consequents  of  production  rules,  none  are  required  in  this  application. 

P.  THE  AGENT  ENGINE 

The  inference  engine  must  be  custom  built  for  this  project.  In  addition  to  the 
constructions  documented  in  other  parts  of  this  document,  it  will  have  other  components 
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important  to  real-time  efficiency  and  embedded  applications  (in  this  case,  operating  to  support 
an  intelligent  agent). 

1.  Rule  Order  and  the  Academic  Paradigm 

The  tradition  has  been  that  rules  can  be  added  to  knowledge  bases  as  they  are  constructed 
without  regard  to  the  concepts  we  normally  think  about  in  “structured  programming.”  In  fact, 
relatively  arbitrary  rule  ordering  and  entry  (via  rule  editor)  is  often  seen  as  a  virtue.  To  make  this 
feature  possible,  inferences  engines  repeatedly  cycle  through  the  rules  until  one  complete  pass  is 
made  in  which  no  new  inferences  are  made.  Given  a  pathological  rule  ordering,  this  strategy  can 
make  inferencing  very  slow,  which  cannot  be  tolerated'in  a  real-time  application. 

Nor  is  it  necessary.  The  rules  in  the  Agent  Inference  Engine  are  ordered  (normalized)  so 
that  a  slot  in  an  antecedent  never  appears  before  its  uses  as  a  consequent.  Thus  the  rule  order  is 
always 

IF  A 

B 

THEN  C 

IF  C 

THEN  D 

and  never  the  reverse: 

IF  C 

THEN  D 

IF  A 

B 

THEN  C 

In  the  first  case  the  inference  engine  examines  the  two  rules  and  quits.  In  the  second  case 
it  has  to  process  the  rules  three  times:  the  first  time  fires  the  second  rule,  the  second  time  fires 
the  first  rule,  and  the  third  time  fires  no  rule  (and,  so,  terminates  inferencing).  A  complex 
knowledge  base  can  therefore  be  either  expensive  or  cheap  depending  upon  the  ordering  of  the 
rules.  Other  than  tradition,  there  is  no  argument  in  favor  of  arbitrary  rule  ordering.  It  is  simply  a 
bad  idea. 
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Secondly,  ordered  rules  are  much  easier  to  read.  There  is  no  reason  why  rules  cannot  be 
read  from  top  to  bottom  in  a  single  pass — ^which  is  the  well-proven  idea  behind  structured 
programming.  Easy  to  read,  easy  to  maintain,  less  apt  to  have  bugs.  Importantly,  it  is  much 
easier  to  tell  wfren  a  rule  set  is  complete  when  it  is  normalized. 

2.  Automatic  Rule  Sorting  and  Parallel  Processing 

Note  that  recursion  can  span  over  many  rules  making  it  difficult  to  spot.  For  this  reason, 
in  the  final  implementation,  the  rule  editor  associated  with  Agent  will  automatically  sort  the 
rules,  in  normalized  order,  and  detect  any  circularities  in  the  process.  This  is  not  a  trivial  thing  in 
that  rules  can  recursively  activate  the  inference  engine  on  other  rule  bases  that  can  instantiate 
facts  that  create  recursions  (or  affect  the  rule  ordering). 

A  certain  subset  of  the  rules  being  sorted  must  occur  in  normalized  order.  On  the  other 
hand,  there  can  be  rules  between  elements  of  the  subset  in  >^diich  the  order  is  irrelevant.  These 
rules  may  be  tested  for  firing  concurrently  if  multiple  processors  are  available.  The  rule  sorting 
mechanism  can  insert  the  directive  PARALLEL  before  a  group  of  such  rules,  and  END 
PARALLEL  after  them.  The  inference  engine  can  then  send  each  of  the  rules  between  the  two 
directives  to  fecial  instantiations  of  itself  operating  on  different  processors.  The  END 
PARALLEL  directive  pauses  if  not  all  of  the  rules  in  a  parallel  section  have  been  examined.  The 
result  is  a  much  faster  engine,  better  suited  to  real-time  applications.  In  general  a  long  rule  base 
will  have  many  such  opportunities  for  parallel  processing.  The  sorter  makes  them  automatic. 

3.  Functions  Within  Consequents 

Another  great  benefit  of  normalizing  rule  bases  is  that  effector  functions  can  be  used  in 
the  consequents  of  ordinary  rule  bases,  knowing  that  they  will  take  action  predictably  (that  is,  a 
function  in  a  rule  will  be  invoked  before  a  function  in  a  subsequent  rule).  Thus  the  Agent 
inference  engine  can  not  only  recognize  situations,  but  it  can  also  safely  take  action  to  alter 
things  outside  of  itself. 
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4. 


Nested  Inferencing 


As  mentioned  in  the  description  of  the  INFER  directive,  knowledge  bases  can  call  other 
knowledge  bases.  This  nesting  can  be  taken  to  any  depth,  as  needed.  The  idea  is  to  partition 
knowledge  bases  for  clarity  and  efficiency.  For  example,  a  call  to  INFER  presumes  various 
facts,  so  that  the  rules  being  activated  to  not  have  to  test  for  their  truth.  They  simply  assume  that 
if  they  are  being  activated,  certain  conditions  hold.  This  makes  for  much  simpler  rules.  For 
example,  within  the  confines  of  a  Link  16  network,  bandwidth  availability,  as  dictated  by  the 
spread  ^ectrum  architecture  of  a  given  network  configuration,  places  limitations  upon  the 
volume  of  data,  and  periods  of  transmission  and  receipt.  To  that  end,  the  INFER  in  this  instance 
is  that  the  Agent  is  to  process  all  information,  and 'forward,  without  regard  to  the  Link  16 
constraints.  Another  portion  of  the  Link,  is  available  to  carry  out  the  required  network 
transmission  /  receipt  functions. 

5.  Compiling 

Rule  sets  can  be  compiled  in  the  Agent  system  or  they  can  be  run  interpretively.  The 
reason  rules  can  be  compiled  is  that  slot  references  for  all  dynamic  objects  are  fixed  (or  can  be, 
if  modifications  to  the  class  structure  of  the  semantic  network  during  run  time  are  disallowed). 
Without  compilation,  in  order  to  find  a  message  instance  it  is  necessary  to  search  through  the  net 
starting  with  the  null  object.  Once  compiled,  however,  the  inference  engine  can  go  directly  to  the 
instantiations.  Any  null  object  slots  that  are  predefined  can  also  be  referenced  in  this  way.  Slot 
items  that  are  defined  during  run  time  require  dynamic  look  up. 

The  advantage  of  interpreting  the  rules  is  that  a  standard  validation  mechanisms  can  be 
used,  such  as  automatic  rule  tracing  and  query  (e.g.,  “Why  did  Agent  force  transmission  of  that 
message  >\fien  it  did?”).  The  compiled  version  has  no  such  features  and  is  designed  solely  for 
efficiency.  Thus  the  interpreted  version  is  used  for  building  and  debugging,  while  the  compiled 
version  is  used  in  the  fielded  versions  of  Agent. 
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6. 


The  WHILE  Construction 


There  are  times  when  it  becomes  necessary  to  have  the  inference  engine  iterate  over  a  set 

of  rules  in  a  knowledge  base.  The  WHILE  construction  allows  this.  Its  form  is  as  follows: 

WHILE  <truth  expression> 

BEGIN  [name] 

<rules> 

END  [name] 

While  the  expression  remains  true  (e.g.,  “The  house  is  red”,  “The  value  is_greater_than_ 
10”),  the  rules  between  BEGIN  and  END  are  iterated.  An  EXIT  appearing  within  the  scope  of 
BEGIN  and  END  causes  the  WHILE  to  be  retested — it  does  not  exit  to  the  meta  controller. 

The  WHILE  construction  can  be  nested  indefinitely  for  complex  processing.  In  Agent, 
where  many  updates  can  be  bundled  within  a  single  Agent  message,  the  WHILE  construction 
enables  a  single  set  of  rules  to  decode  all  of  the  updates  without  having  to  return  to  the  meta 
language  level. 

The  name  on  BEGIN  or  END  is  entirely  optional.  Its  use  enhances  readability.  However, 
if  a  name  is  given  on  the  BEGIN  the  identical  name  must  be  given  on  the  corresponding  END. 

7.  BREAK 

BREAK  [string]  causes  a  jump  to  the  test  of  a  WHILE  statement,  or  an  exit  from  a 
knowledge  base  to  the  meta  level  if  not  within  a  WHILE  statement.  The  string  is  optional  (for 
readability). 

Q.  SHARED  MEMORY 

Shared  memory  references  that  common  memory  utilized  by  an  Agent  on  a  singular 
node.  The  processes  of  an  Agent  communicate  through  global,  shared  memory  (RAM).  Both 
persistent  and  perishable  knowledge  is  stored  in  shared  memory.  Persistent  knowledge  is  created 
at  initialization  with  a  special  form  of  facts,  while  perishable  knowledge  is  created  by  the  firing 
of  rules  during  inferencing. 
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There  are  many  uses  of  shared  memory.  For  example,  shared  components  of  the 
architecture  maintains  the  operating  mode,  network  loading  factors,  and  encoding  scheme  in  use 
in  shared  memory.  The  Shared  Component  is  the  only  process  that  sets  these  slot  values  within 
shared  memory.  All  other  components  simply  reference  them. 

Also,  if  there  are  multiple  processors  operating,  any  available  processor  in  the  delta 
components  can  take  reqwnsibility  for  processing  a  given  entry  message  simply  by  locking  it 
and  changing  its  status. 

Since  output  messages  to  the  terminal  must  be  batched  (since  the  terminal  normally  sends 
three  or  six  word  transmissions),  there  exists  a  single  output  message  object  that  all  processors 
share.  Each  contributes  a  delta  update  until  the  message  is  long  enough  for  effective 
transmission. 

Various  locking  mechanisms,  described  above,  make  this  sharing  possible  through  a 
crude  form  of  synchronization.  Shared  memory  resembles  a  blackboard  structure  when  multiple 
processors  are  involved,  because  each  scans  shared  memory  to  determine  what  to  do. 

Far  example,  an  output  process  constantly  looks  for  messages  with  status  “output.” 

(There  is  one  output  process  for  each  direction  (to  terminal,  to  host).)  Two  antecedents  are 

enough.  In  the  following  case,  the  right  output  processor  selects  its  messages: 

IF  The  status  of  ANY  message  is  output 

The  direction  of  THAT  message  is  right 
THEN  LOCK  that  message 

THAT  message  is_a  output_message 
DEINSTANTIATE  that  message  FROM  temporary_message 


R.  META  CONTROL  AND  META  LANGUAGE 

As  will  be  shown  in  the  detailed  descriptions  below,  the  meta  language  is  generally  rather 
simple  in  implementation.  Agent  has  been  designed  to  minimize  the  complexity  of  the  meta 
language  needed  to  drive  it. 

The  metalanguage  is  interpreted  and  is  loaded  into  Agent  at  initialization  time. 

A  small  run-time  kernel  for  each  process  is  needed  to  interpret  and  execute  the  meta  rules 
for  that  process. 
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1. 


Meta  Control  Functions 


a.  LOOP 

(LOOP  (<fact>)  (<factset>)  (<scope>)) 

Repeatedly  executes  the  scope  as  long  as  the  fact  is  trae  in  the  factset. 

b.  EVENT 

(EVENT  (<fact>)  (<scope>)) 

EVENT  executes  the  scope  whenever  the  fact  is  true  in  the  default  or  global  factset.  This 
is  a  way  that  system  events  (such  as  “shut  down” )  can  affect  running  processes.  EVENT  differs 
from  LOOP,  in  that  EVENT  is  triggered  by  “true”  condition  in  the  default,  or  global  factset. 
LOOP  is  a  directed  (program)  statement,  which  will  execute  vsdien  directed,  and  continue 
execution  as  long  as  the  determining  fact  is  true. 

c.  INFER 

(INFER  (<knowledge  base>)  (<input  facts>)  (coutput  facts>)) 

INFER  causes  the  knowledge  base  ^cified  to  be  processed  using  the  input  facts.  The 
result  of  the  inferencing  process  is  the  set  of  output  facts. 

d.  EXIT 

(EXIT  )  causes  the  process  to  terminate. 

e.  CREATE 

(CREATE  (<factset>)  (<factsetname>)) 

CREATE  explicitly  creates  a  factset  with  the  name  supplied.  Factsets  are  also  created 
implicitly  be  reference. 


61 


f.  RELEASE 


(RELEASE  (<factset>)) 

This  deletes  the  named  factset. 

g.  ADDFACT 

(ADDFACT  (<fact>)  (<factset>)) 

Adds  a  fact  to  a  factset. 

h.  DELFACT 

(DELFACT  (<fact>)  (<factset>)) 

Removes  a  fact  from  a  factset. 
u  IS_TRUE 

(IS_TRUE  (<fact>)  (<factset>)) 

Returns  TRUE  if  the  fact  is  true  in  the  factset. 

j.  IS_FALSE 

(IS_FALSE  (<fact>)  (<factset>)) 

Opposite  of  TRUE. 

k.  IF 

(IF  (<truth  function>)  (<scope>)) 

IF  executes  the  scope  when  the  truth  function  evaluates  to  true.  Generally,  this  will  be 
seen  as  follows: 

(IF  (TRUE  (<fact>)  (<factset))  (<scope>)) 
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L  MERGE 

(MERGE  (<factsetl>)  (<factset2>)  (<factset3>)) 

Causes  the  facts  from  factsetl  to  be  combined  with  the  facts  in  factset2  to  form  factsetS 
(which  can  be  the  same  name  as  either  of  the  first  two  sets).  If  a  fact  is  true  in  either  factsetl  or 
factset2  then  the  true  fact  is  in  the  output  factsetS.  If  both  factsetl  and  factset2  are  true,  both 
truths  are  added  to  the  output  factsetS.  If  neither  factsetl  or  factset2  are  true,  then  this  instance 
of  the  merge  produces  a  null  output,  or  no  merge  for  this  fact  only. 

m.  EFFECT 

(EFFECT  (<fimction>)  (<parameter  list>)) 

EFFECT  calls  the  function  given  with  the  parameter  list  given.  This  is  a  catch-all  for 
any  function  that  is  useful. 

n.  NOTIFY 

(NOTIFY  (<string>)) 

Sends  a  string  to  the  operator  console. 
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IV.  AGENT  ARCHITECTURE 
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Figure  20,  Agent  Architecture 


A.  LINK  MANAGER 

The  Link  Manager  enforces  the  time  rules  of  the  network,  as  well  as  performing 
housekeeping  ftmctions  for  Agent.  If  only  the  Shared  Message  Structure  and  the  Link 
Manager  existed,  the  network  into  which  Agent  was  inserted  would  function  normally. 
Messages  would  be  intercepted  from  the  left  (host)  or  right  (terminal),  be  placed  into  the 
structure,  age,  and  then  be  asserted  on  the  output  network  or  bus  in  the  correct  direction 
(that  is,  to  the  host  or  to  the  terminal). 


65 


“Left"  side 
TIMS 
Host, 


1  Scalable  Global  Memory  j 

1 

n 

r  — 1 - 1 - 1 - 1 - 1 - 1 - 1 — 1  1  I  I  1  1  1  1 

1  Shared  Message  Structure 

■  ■■  4,  - - 

“Right"  side 
TOMS 
Transmitter 


Gateway 


Gateway 


Figure  21,  Link  Manager 

Agent,  at  the  physical  level,  is  a  severance  implementation.  That  is,  the  network 
or  bus  between  the  host  and  the  terminal  are  physically  severed,  and  the  Agent  hardware 
is  inserted  at  the  severance  point.  The  software  functions  by  interception.  Messages 
coming  in  either  direction  are  intercepted  by  Agent,  processed,  and  then  asserted  back  on 
the  network  or  bus.  The  messages  may  be  asserted  in  their  original  form  or  in  Agent 
format.  If  repetition  rate  reduction  is  in  effect,  outgoing  messages  (that  is,  messages  from 
the  host  to  the  terminal)  can  be  deleted  by  Agent, 

Each  of  the  components  of  the  Link  Manager  is  a  separate  process.  They  may 
very  well  be  implemented  on  separate  processors,  in  order  to  meet  run  time  requirements. 
They  all  operate  asynchronously,  communicating  indirectly  through  the  Shared  Message 
Structure. 
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B.  SIMPLIFYING  ASSUMPTIONS  FOR  THE  PROTOTYPE 


It  is  assumed  that  J-Series  messages  of  types  3.2  (air  track),  3.3  (surface  track), 
and  2.2  (Air  PPLI)  are  of  interest — ^all  others  are  not.  This  assumption,  as,  indeed,  all 
other  assumptions,  is  entirely  rule  or  fact  driven  and  not  internal  to  Agent. 

It  is  assumed  that  there  is  a  fixed-length  message  header  in  all  outgoing  messages. 
It  is  assumed  that  the  type  of  message  is  in  this  header  as  well  as  in  the  message  itself 
The  time  the  message  was  originated  is  presumed  to  be  in  the  header.  There  is 
also  a  field  in  the  header  that  indicates  that  an  outgoing  message  must  be  acknowledged. 
However,  this  field  is  ignored  at  this  time  because  none  of  the  types  processed  require 
acknowledgment.  If  a  type  is  at  some  point  handled  that  does  require  acknowledgment,  it 
can  simply  be  passed  through  as  is  (it  is  presumed  that  such  messages  are  a  rare 
occurrence). 

For  simplification,  each  J-Series  message  is  presumed  to  be  the  same  length.  Each 
contains  the  following  fixed-length  fields: 

•Message  Type 
•Track  Number 
•Update  Time 
•Latitude 
•Longitude 

Of  course,  real  messages  have  considerably  more  fields  tiian  this.  However,  they 
would  be  handled  in  precisely  the  same  way  as  the  identified  fields.  It  is  presumed  that 
the  field  positions  within  the  three  update  types  of  interest  are  identical. 

The  “Update  Time”  field  refers  to  the  time  of  the  observation  or  update,  not  the 
time  the  message  was  originated  or  the  current  time.  It  is  also  presumed  diat  the  time  in  a 
series  of  these  updates  is  predictable  plus  or  minus  a  small  delta.  Therefore  an  Agent, 
looking  at  the  last  few  update  messages,  can  determine  if  it  has  a  complete  recent 
sequence  fi'om  these  times. 
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1.  Left  Input  Process 


The  left  input  process  is  alerted  to  the  arrival  from  the  host  of  a  message.  It  has 
the  following  responsibilities: 

•Receives  event  notification  from  system  I/O  handler  (left  side) 

•Determines  message  type 
•Instantiates  the  message  in  shared  memory 

•If  of  an  interesting  type  (e.g.,  one  that  will  eventually  be  transmitted  in  raw  or 

Agent 


form  by  the  terminal)  it  sends  it  to  the  Message  Store 
•Sets  the  direction  to  “left” 

Sets  the  status  slot  to  “entry” 

a.  Production  Rules 

This  knowledge  base  is  identified  as  “Leftinput,”  It  requires  no  facts  except  the 
event  type  (it  doesn’t  actually  need  the  event  type  either,  if  the  only  event  type  it  handles 
is  new  message). 

IF  Event  is  new_message 

THEN  LOCKn’ 

n  =  n+  1 
UNLOCK  n 

message[n]  is_a  message® 

&nchars  =  0 

The  string  of  message[n]  is  FIELD 

(leftinputbuffer,  1  ,&nchars)’ 

Type  of  message[n]  is  FIELD  (string  of  message[n], 
position  of  type,  size  of  type) 

ELSE  EXIT 


’  There  are  three  processes  that  can  create  new  messages,  and  all  must  use  unique  names  to  do  so. 
Therefore  they  all  use  the  global  slot  “n”  to  do  this.  If  the  variable  is  already  locked  the  process  hangs 
until  the  variable  is  unlocked  by  the  locking  process. 

*  Until  we  know  wdiat  type  of  message  we’re  handling,  it  will  be  instantiated  simply  as  a  “message.” 
Later,  it  will  be  instantiated  properly  (using  multiple  instantiation),  then  deinstantiated  from  message  (so 
that  we  won’t  have  multiple  links  to  the  same  message  in  the  same  subtree  of  the  semantic  network. 
•When  the  third  argument  to  FIELD  is  null  or  zero,  this  is  a  signal  for  FIELD  to  return  the  number  of 
characters  transferred  from  a  system  routine.  When  the  third  argument  is  positive,  it  specifies  the  number 
of  characters  FIELD  will  return.  In  this  case  we  are  interested  in  the  entire  message,  so  nchars  is  set  to 
zero  before  the  call,  insuring  that  all  of  the  input  data  will  be  transferred. 
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IF  The  FIELD  (type  of  message[n],  1, 1)  is  “T”® 

THEN  The  class  of  message[n]  is  interesting  ONLY 

ELSE  The  class  of  message[n]  is  uninteresting  ONLY 

The  type  of  message[n]  is  housekeeping 
Message[n]  is_a  output_message 
The  direction  of  message[n]  is  right 
The  status  of  message[n]  is  output 
DEINSTANTIATE”  message[n]  FROM  message*^ 

IF  (The  type  of  message[n]  is  J3.2  OR 

The  type  of  message[n]  is  J3.3  OR 
The  type  of  message[n]  isJ2,2) 

THEN  The  interest  of  message[n]  is  targeted  ONLY 

ELSE  The  interest  of  niessage[n]  is  not_targeted  ONLY 

IF  The  interest  of  message[n]  is  targeted 

THEN  Message[n]  is_a  track_update’^ 

DEINSTANTATIATE  message[n]  FROM  message 
The  message  time'^  of  message[n]  is  FIELD  (string  of 
message[n],  position  of  message_time,  size  of 
messagetime) 

The  update_time‘*  of  message[n]  is  FIELD  (string  of 
message[n],  start  of  time,  size  of  update_time) 

The  track  of  message[n]  is  FIELD  (string  of  message[n], 
position_of_track,  size  of  track) 

The  lat  of  message[n]  is  FIELD  (string  of  message[n],  start 
of  latitude,  size  of  latitude) 

The  Ion  of  message[n]  is  FIELD  (string  of  message[n], 
start  of  longitude,  size  of  longitude) 

The  header  of  message[n]  is  FIELD  (string  of 
message[n],l,  size  of  header) 


Using  quote  marks  ensures  that  the  comparison  will  be  to  the  character  J.  Otherwise  the  comparison 
would  be  to  the  value  found  in  the  J  slot  of  the  null  frame. 

"  Recall  that  this  DEINSTANTIATE  removes  the  message  only  from  the  class  message.  It  has  also  been 
instantiated  as  a  track  update  message  and  is  not  removed  fix>m  class  track  update.  IF  there  had  not  been 
multiple  instantiations,  the  message  would  have  been  deleted  by  DEINSTANTIATE. 

Note  that  we  did  not  instantiate  this  message  as  a  “housekeeping  message”  because,  unless  the  actual 
implementation  gets  into  buffer  management,  housekeeping  messages  mean  nothing  to  Agent 

Although  we  could  retrieve  the  message  type  using  FIELD,  we  already  know  it  has  to  be  “update” 
because  of  the  J-series  type. 

The  “message  time”  is  the  time  in  the  message  header  used  for  host-terminal  bookkeeping  and 
checking. 

The  “update  time”  is  the  time  of  the  sighting,  as  produced  by  surveillance  processing.  It  is  separate  and 
distinct  from  the  message  time.  “At  update  time  X  vehicle  Y  was  at  position  Z,  and  the  mssage  was 
created/sent/originated  at  message  time  A”  may  demonstrate  the  difference  in  meaning. 
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The  direction  of  message[n]  is  left 
LOCK!'* 

J  =  J+1 
UNLOCK! 

message[j]'^  is_a  raw_stream 
The  size  of  message[j]  is  &nchars  -  headersize_out'* 
The  message  time  ofmessage[j]  is  the  message  time  of 
message[n] 

The  status  of  message[n]  is  entry” 

EXIT 

IF  The  class  of  message[n]  is  interesting 

The  value  of  message[n]  is  not  targeted 
THEN  Message[n]  is_a  ouQ)ut_message 

DEINSTANTIATE  message[n]  FROM  message 
The  direction  of  message[n]  is  right 
LOCK! 

J  =  J+1 
UNLOCK! 

messageU]  is_a  raw  stream 
The  size  of  message[j]  is  &nchars  -  headersize_out 
The  message_time  ofmessage[j]  is  the  message_time  of 
message[n] 

The  status  of  message[n]  is  ou^ut 

b.  Meta  Rules 


(LOOP  (EVENT"®  (“Left  Input  Message”)) 

( 


) 


(INFER  (“Event  is  new_message”)  (“Leftinput”) 
(“OutFacts”)) 


J  has  to  be  locked  because  the  right  input  process  and  the  decoding  processes  create  such  objects  and 
all  have  to  be  unique.  Naturally,  all  processes  that  create  history  records  use  J. 

Case  is  ignored  in  Agent.  Case  can  be  used  in  the  facts  and  rules  to  make  them  easier  to  read. 

'*  J-Series  messages  can  be  of  several  different  lengths.  The  header  is  of  fixed  length  for  all  host-to- 
terminal  messages.  If  the  trigger  is  supplied  by  operating  system  elements  or  Gateway,  and  the  number  of 
characters  in  the  input  buffer  can  be  known,  then  Agent  does  not  have  to  keep  track  of  the  size  of  each 
message  type.  On  the  other  hand,  if  the  input  components  do  not  tell  the  size  of  the  message,  then  input 
facts  must  supply  the  length  in  characters  of  each  formatted  message. 

”  All  other  processes  are  concerned  primarily  with  the  status  of  a  message.  Until  the  status  slot  is  set,  no 
other  process  vwll  touch  the  message  being  built.  As  soon  as  that  status  is  set  the  rule  bases  of  other 
processes  may  operate  on  the  message. 

“  EVENT  waits  until  triggered  by  a  system  process.  Gateway,  or  other  process. 
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2. 


Left  Output  Process 


The  left  output  process  asserts  messages  on  the  network  connection  leading  to  the 
host  computer  system.  For  Link- 16,  these  are  known  as  TOMs  (Terminal  Output 
Messages).  Agent  messages  can  also  be  sent  to  the  host  by  this  process.  For  other  digital 
networks  \\diere  a  severance  implementation  is  appropriate,  these  are  messages 
originating  from  the  right  side. 

a.  Production  Rules 


IF 

The  status  of  ANY  message  is  output 

The  direction  of  THAT  message  is  left 

THEN 

&pos=  1 

IF 

The  message  of  THAT  message  is  to_be_constructed 
The  type  of  THAT  message  is  J-Series 

THEN 

The  string  of  THAT  message  is  NULL 

The  string  of  THAT  message  is  FIELD  (the  string  of 

THAT  message,  &pos,  MAKEHEADERO)^' 

&pos  =  &pos  +  size  of  right_header 
The  FIELD  (the  string  of  THAT  message,  &pos,  the  track 
of  that  message) 

&pos  =  &pos  +  size  of  track 

The  FIELD  (the  string  of  THAT  message,  &pos,  the  lat  of 
that  message) 

&pos  =  &pos  +  size  of  lat 

The  FIELD  (the  string  of  THAT  message,  &pos,  the  Ion  of 
that  message) 

«&pos  =  &pos  +  size  of  Ion 

The  FIELD  (the  string  of  THAT  message,  &pos,  the 
update_time  of  that  message) 

The  status  of  THAT  message  is  old 
The  message  of  THAT  message  is  constructed  ONLY 
ELSE  EXIT  “Error — Can  only  construct  update  messsages” 


IF  The  message  of  THAT  message  is  constructed 


■'  In  Link-16,  there  is  a  five  word  header  on  TOMs,  or  Terminal  Output  Messages.  MAKEHEADER 
creates  this  legal  header.  Since  the  contents  of  the  headers  of  both  TIMs  and  TOMs  is  classified,  this 
function,  or,  most  probably,  knowledge  base,  has  been  omitted. 
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The  type  of  THAT  message  is  not  J-Series“ 

THEN  FIELD  (left  output  bufFer,  1,  size  of  THAT  message)^^ 

TRIGGER  (left_output_buffer,  &pos)^‘* 

EXIT 

IF  The  message  of  THAT  message  is  constructed 

THEN  LOCKJ 

J  =  J+  1 
UNLOCK! 

messageQ]  is_a  raw_stream 
The  size  of  raw_stream(j]  is  SIZE  (string  of  THAT 
message)^  -  headersizein^* 

The  message  time  of  raw_stream[j]  is  the  message  time  of 
THAT  message 

FIELD  (Ieft_output_bufFer,  1,  size  of  THAT  message)^^ 
TRIGGER  (left_output_buffer,  &pos)^* 


3.  Exception  Handler 


The  exception  handler  has  several  responsibilities.  First,  it  must  see  diat  messages 
that  have  been  delayed  too  long  by  Agent  (too  long  as  defined  in  the  facts)  are  properly 


^  Therefore  it  has  to  be  an  housekeeping  message. 

^  The  FIELD  function  now  moves  the  message  string,  which  will  look  to  the  host  as  if  it  were  a  standard 
message,  to  the  system  (or  Gateway)  output  buffer. 

^  TRIGGER  tells  the  system  that  the  buffer  specified  by  the  argument  is  ready  for  insertion  on  the  bus  or 
network  connection  on  either  side  of  Agent.  The  second  argument  is  the  size  of  the  message.  These 
arguments  are  notional  in  that  the  specific  steps  and  forms  will  be  determined  for  Agent  during  detailed 
design  for  a  particular  installation. 

SIZE  returns  the  number  of  characters  found  in  its  argument.  SIZE  must  be  used  carefully  where  values 
are  subject  to  concatenation.  In  general,  if  there  are  multiple  values,  SIZE  returns  the  length  of  only  the 
first  value. 

header  of  an  “in”  message  refers  to  the  header  of  a  message  fi-om  terminal  to  host.  The  header  of  an 
“out”  message  refers  to  the  header  of  a  message  going  to  the  terminal.  J-Series  messages  can  be  of 
several  different  lengths.  The  header  is  of  fixed  length  for  all  host-to-terminal  messages  (currently  10 
words)  and  terminal  to  host  message  (currently  5  words).  If  the  trigger  is  supplied  by  operating  system 
elements  or  Gateway,  and  the  number  of  characters  in  the  input  buffer  can  be  known,  then  Agent  does  not 
have  to  keep  track  of  the  size  of  each  message  type.  On  the  other  hand,  if  the  input  components  do  not 
tell  the  size  of  the  message,  then  input  facts  must  supply  the  length  in  characters  of  each  formatted 
message. 

”  The  FIELD  function  now  moves  the  message  string,  which  will  look  to  the  host  as  if  it  were  a  standard 
message,  to  the  system  (or  Gateway)  output  buffer. 

“  TRIGGER  tells  the  system  that  the  buffer  specified  by  the  argument  is  ready  for  insertion  on  the  bus  or 
network  connection  on  either  side  of  Agent.  The  second  argument  is  the  size  of  the  message.  These 
arguments  are  notional  in  that  the  specific  steps  and  forms  will  be  determined  for  Agent  during  detailed 
design  for  a  particular  installation. 
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forwarded  within  allowable  time  limits.  Second,  it  looks  for  “collisions,”  which  occur 
when  an  update  on  a  track  is  received  before  a  pending  update  has  reached  output  status. 
A  collision  forces  the  pending  message  to  be  sent  immediately  (with  all  of  die  other 
messages  tiius  far  batched  with  it).  Finally,  it  “prunes”  the  shared  message  structure  of 
message  so  old  as  to  no  longer  be  of  interest. 

a.  Production  Rules 

Rules  for  the  exception  handler  are  central  to  the  overall  design  of  the  rule  bases. 

The  first  is  a  message  whose  status  has  stayed  “entry”  too  long  (the  “Aged  Entry 
Message”).  Because  its  status  is  “entry”  it  is  not  either  now  or  soon  to  become  a 
component  of  the  temporary_message  or  the  ou^ut_message.  Therefore  it  is  instantiated 
as  an  output  message  and  otherwise  deinstantiated. 

If  the  status  of  a  message  is  “encoding,”  then  some  process  has  either  already 
added  it  to  the  temporary_message  or  will  soon  do  so.  The  exception  handler  will  output 
the  temporary  message  if  the  ID  is  there.  Otherwise  it  does  nothing  at  this  point  because 
one  of  the  processes  will  soon  add  the  ID  to  the  temporary  message.  If  the  entry  is  idle 
for  too  lond  a  period  of  time,  as  determined  by  network  rules  of  operation,  the  message, 
upon  updating  of  the  temporary  storage  buffer,  will  have  the  appropriate  ID  established, 
and  transmitted.  This  is  not  an  arbitrary  process,  but  rather  a  trade  off  between  the  desire 
to  maximize  thje  fill  of  each  transmitted  packet,  v.s.  the  time  constrains  of  transmission. 
At  a  subsequent  inferencing,  that  rule  base  will  find  the  ID  in  the  temporary  message  and 
force  that  message  to  be  sent. 

The  third  exception  has  to  do  with  an  update  arriving  for  the  same  track  that  is 
cxirrently  being  processed.  In  this  version  of  the  rules,  the  base  forces  the  output  of  the 
temporary  message  and  allow  the  new  update  to  be  processed  normally. 

Old  messages  that  are  no  longer  of  value  to  Agent  are  pruned  so  that  the  space 
can  be  made  available  for  additional  messages.  This  store  of  old  message  is  used  by 
various  heuristics  to  construct  or  deconstruct  Agent  reduced  messages. 

Finally,  objects  which  are  used  to  determine  network  and  NPG  loading  are 
purged  after  they  are  no  longer  useful  in  determining  net  and  node  saturation  levels. 
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( 1 )  Aged  Entry  Message 

IF  The  status  of  ANY  message  is  entry^’ 

The  direction  of  THAT  message  is  left 
The  type  of  THAT  message  is  track_update 
The  TIME/®  minus  the  message_time  of  THAT  message 
is  greater  than  the  update_processing_limit 
THEN  LOCK  THAT  message 

The  status  of  THAT  message  is  output 
The  direction  of  THAT  message  is  right 
The  status  of  THAT  message  is  old 
The  message  of  THAT  message  is  constructed  ONLY 
UNLOCK  THAT  message 

The  status  of  ANY  message  is  entry 
The  direction  of  THAT  message  is  right 
The  type  of  TEL\T  message  is  track_update 
The  TIME/  minus  the  time  of  THAT  message 

is_greater_than  the  update_processing_limit 
LOCK  THAT  message 
The  status  of  THAT  message  is  output 
The  direction  of  THAT  message  is  left 
The  status  of  THAT  message  is  old 
The  message  of  THAT  message  is  constructed  ONLY 
UNLOCK  THAT  message 

The  status  of  ANY  message  is  entry 
The  direction  of  THAT  message  is  right 
The  type  of  THAT  message  is  housekeeping 
The  TIME/  minus  the  time  of  THAT  message 

is_^eater_than  the  housekeeping  processing  limit 
LOCK  THAT  message 
The  status  of  TKIAT  message  is  output 
The  direction  of  THAT  message  is  left 
The  status  of  THAT  message  is  old 
The  message  of  THAT  message  is  constructed  ONLY 
UNLOCK  THAT  message 

The  status  of  ANY  message  is  entry 
The  direction  of  THAT  message  is  right 
The  TIME/  minus  the  time  of  THAT  message 


IF 


THEN 


IF 


THEN 


”  These  rules  cover  the  problem  of  an  entry  message  (left  or  right)  that  has  sat  too  long  without  being 
processed  (encoded  or  decoded). 

This  is  the  current  system  time  (or  other  appropriate  time  reference). 
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is_greater_than  the  general_processing_limit^' 
THEN  LOCK  THAT  message 

The  status  of  THAT  message  is  output 
The  direction  of  THAT  message  is  left 
The  status  of  THAT  message  is  old 
The  message  of  THAT  message  is  constructed  ONLY 
UNLOCK  THAT  message 

Aged  message  being  encoded^^ 

The  status  of  ANY  message  is  encoding^^’^'* 

The  TIME/  minus  the  time  of  THAT  message 

is_jreater_than  the  general_processing_limit^^ 
LOCK  THAT  message 
LOCK  the  temporary_message 
The  status  of  THAT  message  is  late 

IF  The  status  of  ANY  message  is  late 

The  track  of  THAT  message  is_the_same_as  the  track  of 
the  temporary  message 
THEN  LOCK  shared  memory 

The  status  of  THAT  message  is  old 

The  temporarymessage  is_a  outputmessage 

gpos  =  0^® 

DEINSTANTIATE  THAT  message  from 


The  processing  time  limits  have  not  been  determined.  It  is  probable  that  all  J-Series  messages  will  have 
the  same  time  limit,  and,  perhaps,  the  housekeeping  messages  as  well.  On  the  other  hand,  they  could  be 
different.  If  so,  each  message  type  may  have  a  time  limit  associated  with  it  and  these  rules  must  be 
expanded  accordingly. 

Note  that  aging  messages  being  decoded  cannot  be  handled  as  exceptions  because  there  is  nothing 
Agent  can  do  but  continue  to  decode  them.  Until  it  decodes  the  message  it  cannot  even  be  aware  of  which 
tracks  are  involved,  and  therefore  cannot  sense  track  collision  (new  update  arriving  before  old  update  is 
processed).  On  the  other  hand,  decoding  is  one  of  the  fastest  processes.  The  processor  must  be  specified 
so  that  all  messages  are  decoded  fast  enough  so  as  not  to  be  considered  late. 

These  rules  handle  the  case  where  it  is  taking  too  long  to  batch  various  messages  for  output.  What  will 
happen  is  that  the  temporary  message,  which  is  where  all  processes  assemble  batched  messages,  will  be 
output  as  is  and  the  originai  messages  that  are  part  of  that  temporary  messages  will  be  deleted  from 
shared  memory.  This  will  result  in  a  message  with  fewer  updates  than  is  possible,  but  ends  any  further 
delays. 

^  If  the  status  is  “encoding,”  and  it  is  true  that  the  message  originated  from  the  left  (host)  side,  and  Agent 
is  presently  operating  with  reduction,  compression,  or  both.  Since  all  reduced  updates  must  be  batched, 
the  results  of  this  encoding  appear  in  the  temporary  message. 

Additional  rules  may  be  needed  if  the  processing  times  are  different,  as  explained  in  a  previous 
footnote. 

Gpos  is  a  global  counter  used  by  the  encoding  heuristics  to  mark  the  next  available  place  in  the  string 
of  the  Agent  message  being  constructed.  When  a  message  is  deinstantiated  from  the  temporary  message 
class,  then  this  counter  must  be  reset.  Since  the  wdiole  of  ^ared  memory  is  locked  at  this  point,  no 
special  lock  is  required. 


(2) 

IF 

THEN 


75 


temporary_message 
UNLOCK  shared  memory 
UNLOCK  THAT  message 

IF  The  status  of  ANY  message  is  late 

The  track  of  THAT  message  is  not  the  track  of  the 
temporary  message 

THEN  CONTINUE” 

(3)  Collision 

IF  The  status  of  ANY  message  is  entry 

The  track  of  THAT  message  is  the  same  as  the  track  of 
the  temporary_message 
The  direction  of  THAT  message  is  left 

THEN  LOCK  THAT  message 

LOCK  the  temporary  message^* 

The  direction  of  the  temporary  message  is  right 
The  temporary_message  is_a  output_message 
The  status  of  THAT  message  is  old 
gpos  =  0 

UNLOCK  THAT  message 
DEINSTANTIATE  the  temporary_message 

IF  The  status  of  ANY  message  is  entry 

THEN  The  &track  is  the  track  of  THAT  message 

IF  The  status  of  ANY  message  is  encoding 

The  track  of  THAT  message  is  the  track  of  the 
temporary_message” 

The  track  of  THAT  message  is  &track''® 

THEN  LOCK  the  temporary  message^* 

The  direction  of  the  temporary  message  is  right 
The  temporary_message  is_a  output_message 
gpos  =  0 

”  If  the  track  ID  isn’t  in  the  temporary  message  now,  it  will  be  shortly.  The  problem  will  be  caught  on  a 
subsequent  iteration  of  the  rules. 

“  The  temporary  message  class  is  only  used  for  messages  being  encoded.  Therefore  the  direction  will 
always  be  right. 

Added  last  deliberately  for  the  purpose  of  having  this  test  work. 

^  We’re  looking  here  for  an  update  to  a  track  that  is  already  being  encoded.  We  can  detect  this  because 
the  track  number  is  in  the  temporary  message.  This  means  that  the  track  number  is  also  in  a  message 
labelled  encoding.  And  a  new  update  has  arrived.  Therefore  the  action  is  to  force  out  the  temporary 
message  before  processing  the  new  update. 

■*'  The  temporary  message  class  is  only  used  for  messages  being  encoded.  Therefore  the  direction  will 
always  be  right. 
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The  statiis  of  THAT  message  is  old 
UNLOCK  THAT  message 
DEINSTANTIATE  the  temporary_message 

(4)  Message  Pruning 

IF  The  status  of  ANY  message  is  old 

THAT  message  is_a  track_update^^ 

The  NUMBEROF'‘^(THOSE  messages)  is_greater_than 

44 

one 

The  TIME/  of  ANY  message  minus  the  time  of  THAT 
message  is_greater_than  the  persistencelimit^^ 
THEN  DEINSTANTIATE  THAT  message^ 

(5)  History  Record  Pruning 

IF  If  the  TIME/  minus  the  time  of  ANY  history_record 

is^eater  than  2  *  net  frametime 
THEN  DEINSTANTIATE  THAT  history_record 

b.  Exception  Handler  Meta  Rules 

Metarules  are  designed  to  be  simple,  and,  in  the  case  of  the  Exception  Handler, 

they  are  very  simple  indeed.  There  is  one  knowledge  base,  called  “exceptions,”  detailed 

in  the  section  above.  All  the  meta  rules  do  is  loop  on  this  knowledge  base. 

(LOOP  0 

( 

(INFER  0  (“exceptions”)  (“OutFacts”)) 

) 

This  data  base  is  interesting  because  it  requires  no  input  fact  list  (it  merely  needs 
access  to  Shared  Memory),  and  that  it  has  no  use  for  the  output  facts  it  produces.  The  fact 
that  the  input  FactSet  is  null  means  that  each  time  it  is  executed  the  old  facts  generated 
through  inferencing  are  gone.The  purpose  of  the  data  base,  in  this  instance,  is  to  provide 
the  unique  knowledge  reservoir  of  the  associated  network(s)  principles  of  operation.  In 


Other  types  of  messages  (e.g.,  housekeeping.  Agent)  are  pruned  when  decoded  or  encoded. 

NUMBER  returns  the  number  of  objects  instantiated  to  the  class  mentioned. 

**  The  first  ten  numbers  are  defined  as  their  value  in  the  null  class  for  readability. 

The  persistance  limit  is  how  long  we  need  to  keep  old  messages  before  they  no  longer  have  value.  At 
this  point  a  function  could  be  added  to  archive  the  messages  about  to  be  deinstantiated. 

^  This  is  an  example  of  subsetting.  The  set  of  messages  identified  by  the  first  use  of  ANY  is  further 
subsetted  by  the  second  ANY,  so  that  the  DEINSTANTIATE  directive  only  applies  to  the  smallest  subset 
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this  way  the  Exception  Handler  can  be  designed  in  such  a  manner  as  to  be  independent  of 
specifics,  with  respect  to  a  particular  network’s  rules  of  operation,  while  providing 
unique  capability  in  each  instance. 

Of  course,  other  actions  can  be  added,  such  as  logging  functions,  as  desired. 
c.  Right  Input  Process 

The  right  input  process  accepts  messages  from  the  terminal  or  right  side.  If  they 
are  standard  messages  they  are  simply  marked  for  output  after  keeping  track  of  the 
implied  network  loading.  If  they  are  Agent  message  they  are  marked  for  decoding  after 
keeping  track  of  the  amount  of  data  (bits)  that  were  transmitted  over  the  RF  network. 

( 1 )  Production  Rules 

The  name  of  this  knowledge  base  is  “InputRight.” 

IF  Event  is  new_message 

THEN  LOCKm 

m  =  m+  1 
UNLOCK m 
message[m]  is_a  message 

The  type  of  message[m]  is  FIELD  (typejposition  of 
right_header,  size_of_type  of  right  header) 

IF  The  type  of  message[m]  is  housekeeping 

THEN  The  string  of  message[m]  is  FIELD  (right_input_buffer,  1, 

update_size) 

The  direction  of  message[m]  is  left 
The  message  of  message[m]  is  constructed 
The  form  of  message[m]  is  raw 
The  status  of  message[m]  is  output 
EXIT 

IF  The  FIELD(type  of  message[m],  1 , 1 )  is ‘T’ 

THEN  The  type  of  message[m]  is  J-Series^’ 

IF  (The  type  of  message[m]  is  J3.2  OR 

The  type  of  message[m]  is  J3.3  OR 
The  type  of  message[m]  is  J2.2  OR) 

THEN  Message  is  interesting  ONLY 


Recall  that  slot  assignment  implies  concatenation  for  non-numeric  values.  Thus  the  message  type  is 
both  “J-Series”  and  its  original  type  (e.g.,  J3.2,  J3.3,  or  J2.2). 
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ELSE  Message  is  uninteresting  ONLY 

The  form  of  message[ni]  is  raw 

IF  The  type  of  message[m]  is  Agent 

THEN  Message  is  interesting  ONLY 

The  form  of  message[m]  is  encoded 

IF  Message  is  uninteresting 

THEN  The  direction  of  message[m]  is  left 

LOCK! 

J  =  J+1 
UNLOCK! 

message[j]  is_a  raw  stream 
The  rawsize  of  message[m]  is  (SIZEOF  (string  of 
message[m])  7  headersizeout) 

The  time  of  message[m]  is  FIELD  (string  of  message[m], 
start  of  update_time,  lengfti  of  update_time) 

The  message  of  message[m]  is  constructed 
The  form  of  message[m]  is  raw 
Status  of  message[m]  is  ouQ)ut 
EXIT 


IF  Message  is  interesting 

Type  of  message[m]  is  Agent 
THEN  Message[m]  is_a  Agent_message 

DEINSTANTIATE  message[m]  FROM  message 
The  string  of  message[m]  is  FIELD  (right_input_buffer,  1, 
updatesize) 

The  encodmg_scheme‘“  of  message[m]  is  FIELD 

(rigjit_input_buffer,  position  of  scheme,  size  of 
scheme) 

The  message_time  of  message[m]  is  FIELD 

(right_input_buffer,  position  of  message_time,  size 
of  message_time) 

The  direction  of  message[m]  is  right 
The  form  of  message[m]  is  encoded 
The  status  of  message[m]  is  entry 
LOCK! 

J  =  J+  1 
UNLOCK! 


^  The  Agent  encoding  scheme  appears  either  in  the  message  header,  if  possible,  or  in  the  encoded 
message  itself.  If  the  latter,  then  the  first  part  of  the  message  information  is  not  incoded.  This  enables  the 
receiving  node  to  decode  Agent-encoded  messages  without  have  to  be  syncronized  with  the  sending  node 
as  to  what  scheme  is  being  employed. 
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messagejj]  is_a  encoded  stream 
rawsize  of  message[j]  is  SIZEOF  (string  of  message[m])  - 
headerin 

time  of  messageU]  is  message_time  of  message[m] 

EXIT 

IF  Message  is  interesting 

Type  of  message[m]  is  J-Series 
THEN  The  type  of  message[m]  is_a  track_update 

DEINSTANTIATE  message[m]  FROM  message 
The  string  of  message[m]  is  FIELD  (right_input_buffer,  1, 
update_size‘*’) 

The  message  time  of  message[m]  is  FIELD 

(ri^t_input_buffer,  position  of  message_time,  size 
of  message  time) 

The  track  of  message[m]  is  FIELD  (right_input_buffer, 
position_of_track,  size  of  track) 

The  lat  of  message[m]  is  FIELD  (right  input  buffer,  start 
of  latitude,  size  of  latitude) 

The  Ion  of  message[m]  is  FIELD  (right  input  buffer,  start 
of  longitude,  size  of  longitude) 

The  update_time  of  message[m]  is  FIELD 

(right_input_bufifer,  start  of  update  time,  size  of 
updatetime) 

The  header  of  message[m]  is  FIELD  (ri^t_input_buffer, 
start  of  header,  size  of  header) 

The  direction  of  message[m]  is  right 
The  status  of  message[m]  is  output 
The  form  of  message[m]  is  raw 
LOCK! 

J  =  J+1 

unlock; 

messageU]  is_a  raw  stream 

rawsize  of  messageU]  is  SIZEOF  (string  of  message[m])  - 
header_in 

time  of  messageU]  is  message_time  of  message[m] 

EXIT 

(2)  Meta  Rules 

(LOOP  (EVENT  (“Right  input  message”)) 

( 


This  assumes  that  ali  three  update  types  of  interest  are  the  same  length.  If  they  are  of  different  lengths 
then  there  has  to  be  a  rule  for  each  message  type  and  a  specific  update  size  assigned  to  each  type. 
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d. 


(INFER  (“Event  is  newmessage”)  (“InputRight”) 
(“OutFacts”)) 


) 

Right  Output  Process 


The  right  output  process  takes  messages  of  any  class  whose  status  is  “output”  and 
^\ilose  direction  is  “right”  and  asserts  them  on  the  bus  or  network  to  the  terminal.  It  also 
keeps  instantiates  the  necessary  loading  measurement  objects. 

With  respect  to  loading,  left  input  process  has  kept  track  of  the  size  of  raw 
messages  firom  the  host.  The  left  output  process  keeps  track  of  the  size  of  raw  messages 
from  the  terminal.  This  process  keeps  track  of  the  size  of  messages  as  they  will  actually 
be  transmitted. 

When  an  Agent  message  is  decoded,  the  left  output  process  will  kept  track  of  the 
size  of  messages  as  received  (and,  therefore,  take  credit  for  the  size  reduction  of  Agent 
operations).  When  messages  are  encoded,  the  size  of  the  imencoded  versions  is  recorded 
by  the  encoding  heuristics  in  the  temporary  message.  Therefore,  when  it  gets  instantiated 
as  an  output  message,  the  size  that  would  have  been  transmitted  is  known  as  well  as  the 
size  actually  transmitted. 

(1)  Production  Rules 

This  knowledge  base  is  called  “rightout.” 


IF  The  status  of  ANY  message  is  output 

The  direction  of  THAT  message  is  right 
The  class  of  THAT  message  is  interesting 
(The  form  of  THAT  message  is  raw  OR 
The  message  of  THAT  message  is  constructed)^® 

THEN  FIELD  (string  of  THAT  message,  position  of 

message_time,  size  of  message_time)  is  TIME/®' 
FIELD  (right_output_buffer,  1,  SIZEOF(  THAT  message)) 
TRIGGER  (right  output  buffer,  &pos)®^ 


This  message  already  has  a  header 

’’  Time  if  a  function  of  message  input  output,  plus  processing  differential. 

TRIGGER  tells  the  system  that  the  buffer  specified  by  the  argument  is  ready  for  insertion  on  the  bus  or 
network  connection  on  either  side  of  Agent.  The  second  argument  is  the  size  of  the  message.  These 
arguments  are  notional  in  that  the  specific  steps  and  forms  will  be  determined  for  Agent  diuing  detailed 
design  for  a  particular  installation. 
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The  status  of  THAT  message  is  OLD 
LOCKJ 
J  =  J+1 
UNLOCK! 

messagejj]  is_a  raw  stream 
rawsize  of  message|j]  is  SIZEOF  (string  of  THAT 
message)  -  headerin 

time  of  message[j]  is  message_time  of  THAT  message 


IF  The  status  of  ANY  message  is  ouQ)ut 

The  direction  of  THAT  message  is  right 
The  class  of  THAT  message  is  interesting 
The  form  of  THAT  message  is  encoded 
THEN  FIELD  (string  of  THAT  message,  position  of 

message_time,  size  of  message_time)  is  TIME/*^ 
FIELD  (right_output_bufifer,  1,  size  of  THAT  message) 
TRIGGER  (right_output_buffer,  &pos) 

The  status  of  THAT  message  is  OLD 
LOCKJ 
J  =  J+1 
UNLOCK! 

messageU]  is_a  encoded_stream 

rawsize  of  message[j]  is  SIZEOF  (string  of  message[m])  - 
headerin 

time  of  messageU]  is  message  time  of  message[m] 
object[&m]  is_a  encoded  stream 
The  exploded  size  of  messageU]]^  is  the  exploded  size  of 
THAT  message 


(2)  Meta  Rules 

(LOOP  (FALSE(EVENT  (“terminate”))) 

( 

(INFER  0  (“rightout”)  (“OutFacts”)) 

) 


Since  this  is  an  encoded  message.  Agent  created  it  from  one  or  more  other  formatted  messages.  Or  it 
could  be  an  internal  Agent-to-Agent  message.  In  any  case,  it  must  be  assigned  a  message  time  that  the 
terminal  will  consider  to  be  legal.  In  this  example,  the  current  system  time  is  used  as  the  message  time. 
During  detailed  design  the  timing  problems  will  be  fully  resolved. 

The  “exploded  size”  is  simply  the  size  of  the  messages  that  would  have  had  to  have  been  transmitted 
had  Agent  not  been  operating.  This  value  is  calculated  as  the  temporary  message  is  constructed,  update 
by  update. 
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c. 


DELTA  COMPONENTS 


There  are  two  processes  (minimum)  of  the  delta  components — an  encoding 
process  and  a  decoding  process.  They  operate  asynchronously  of  each  other.  There  must 
be  at  least  one  of  each  but  there  can  be  as  many  of  each  as  needed  to  keep  up  with  the 
loading.  Thus  a  platform  with  no  reporting  responsibilities  within  the  Surveillance  NPG 
may  have  a  single  encoder  process  and  as  many  decoders  as  are  needed  to  keep  up  with 
the  flow  of  messages.  A  node  with  reporting  responsibilities  may  have  additional 
encoders  in  order  to  keep  up  with  the  encoding  load.  A  multiprocessor  environment  is 
best  for  this  type  of  architecture.  Figure  22  shows  the  parts  of  the  architecture  discussed 
below. 


Figure  22,  Delta  Components  and  the  Shared  Component 

The  creation  of  new  encoding/decoding  components  is  performed  by  the  load 
analyzer,  which  has  rules  to  determine  the  optimal  number  of  components  for  the  current 
situation. 
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1. 


Encoder 


a.  **Simple  **  Delta  Messaging 

The  original  and  simplest  form  of  delta  messaging  transmits  only  the  fields  that 
have  changed  from  the  previous  update,  and  transmits  them  in  their  original  form.  Thus, 
if  only  the  position  and  message  time  have  changed,  only  these  two  fields  will  be 
transmitted.  The  agent  on  die  receiving  side  will  find  the  previous  message,  supply  tiie 
missing  fields,  and  pass  it  on  to  the  host. 

The  complication  is  that  the  terminal  always  sends  out  three  or  six  word  messages 
regardless  of  how  much  data  is  actually  put  into  the  message.  Therefore  updates  must  be 
“batched”  as  well,  so  that  each  Agent  message  will  be  transformed  into  many  regular  (or 
“raw”)  update  messages  on  the  receiving  end. 

If  multiple  processors  are  working  simultaneously,  therefore,  they  work  to  build 
the  same  update  message  (which  is  wiiy,  as  each  iqidate  is  added,  the  so-called 
“temporary  message”  is  locked). 

( 1 )  Production  Rules 

This  rule  base  is  called  “deltaencode.” 

IF  The  mode  of  Agent  is  simple  delta 

The  status  of  ANY  message  is  entry 
The  direction  of  THAT  message  is  left 

THEN  LOCK_ONE  of  THOSE  messages'^ 

The  encode-message  of  THAT  message  is  NAME  (THAT 
message)®* 

The  status  of  THAT  encode_message  is  encoding 
UNLOCK  THAT  message 

IF  The  track  of  ANY  message  is_the_same_as  the  track  of 


“  LOCK  ONE  is  a  special  version  of  LOCK.  Only  one  of  the  messages  of  the  set  identified  in  the 
antecedents  is  locked.  Which  one  is  locked  is  entirely  arbitrary.  It  is  assumed  that  the  implementation  of 
the  semantic  network  will  cause  the  eldest  message  marked  “entry”  to  be  selected.  Just  as  nested 
specifiers  reduce  the  set  referred  to  by  THAT  or  THOSE,  so  does  LOCK.  After  LOCK,  THAT  or  THOSE 
refer  only  to  the  locked  objects — ^in  this  case  the  message  we  wish  to  handle. 

**  NAME  is  a  fimction  that  returns  the  name  of  the  object.  The  name  was  given  by  concatenation  when 
the  object  was  first  instantiated.  Thus  subsequent  rules  can  refer  to  that  message  by  name. 
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$encode_message^^ 

The  type  of  THOSE  messages  is  old 
The  message  time  of  the  Sencode  message  minus  the 
message  time  of  ANY  of  THOSE  messages 
is_less_than_or_equal_to  the  update_frequency  of 
the  $encode_message^®  +  time_delta®’ 

THEN  The  old_encode_message  is  “empty”  ONLY^ 

The  old  encode  message  is  the  NAME  (THAT  message) 
ONLY 

IF  The  old_encode_message  is  “empty” 

THEN  The  direction  of  the  $encode_message  is  right 
The  $encode_message  is_a  output_message 
The  status  of  $encode_message  is  output 
EXIT 


IF  NUMBEROF  (temporarymessage)  isgreaterthan  zero 

THEN  CONTINUE^*' 

ELSE  LOCK  temporary  message 

LOCK  e“ 
e  =  e+  1 
UNLOCK  e 

rmessage[e]  is_a  temporary_message 
gpos=  1 

FIELD  (string  of  temporary_message,gpos,)  is  the  code 
for*^  simpledelta 

gpos  =  gpos  +  size  of  simple  delta  code 
IF  TRUE 

THEN  FIELD  (string  of  temporary  message,  gpos,)  is  “XX”^ 


Note  that  the  dollar  sign,  or  evaluation  symbol,  tells  the  engine  to  substitute  the  contents  of 
encode_message  in  the  antecedent  before  evaluating  further.  Since  the  name  of  a  message  is  stored  in 
“encode_message,’’  the  name  of  that  message  is  used  in  the  evaluation. 

This  value  is  assigned  when  the  semantic  network  is  built  as  a  slot  associated  with  the  message  type. 
Thus  a  J3.2  may  have  one  update  rate  and  a  J3.3  have  another.  Therefore  new  targeted  messages  are 
assigned  to  the  appropriate  type  of  message  rather  than,  simply,  to  “message.” 

”  If  update  times  do  not  form  a  completely  accurate  sequence,  then  peAaps  a  small  delta  will  be  needed 
to  make  sure  that  the  correct  earlier  message  was  located.  If  no  previous  update  is  found  the  message  will 
simply  be  transmitted  in  raw  format. 

“  Agent  cannot  use  simple  delta  encoding  on  a  message  for  which  it  has  no  immediate  predecessor. 

*'  CONTINUE  is  a  no-op. 

Must  be  global  if  there  are  multiple  instances  of  the  encoding  process  operating. 

63  gjjjj  “fQf”  mean  precisely  the  same. 

XX  is  an  arbitrary  field  code  that  indicates  that  what  follows  is  a  new  message.  The  format  of  the 
batched  message  is  in  general  a  field  code  followed  by  the  field  itself.  Thus  field  code  1  means  update 
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IF 

THEN 

ELSE 


IF 

THEN 

ELSE 


gpos  =  gpos  +  2 

FIELD  (string  of  temporary_message,  gpos,)  is  “01”*^ 
gpos  =  gpos  +  2 

FIELD  (string  of  temporary_message,  gpos,  size  of  type)  is 
type  of  message[e] 

FIELD  (string  of  temporary  message,  gpos,)  is  “02” 
gpos  =  gpos  +  2 

FIELD  (string  of  temporary_message,e)  is  the  track  of 
message[e] 

gpos  =  gpos  +  size  of  track 

FIELD  (string  of  teniporary_message,e)  is  the  update_tinie 
of  message[e]** 

gpos  =  gpos  +  size  of  update  time 

The  lat  of  message[el  is  lat  of  oldencode 
Continue 

FIELD  (string  of  temporary_message,  gpos,  size  of  lat)  is 
the  lat  of  message[e] 
gpos  =  gpos  +  size  of  lat 

The  Ion  of  message[e]  is  the  Ion  of  old_encode 
Continue 

FIELD  (string  of  temporary  message, ,  size  of  Ion)  is  the 
Ion  of  message[e] 
gpos  =  gpos  +  size  of  Ion 

The  exploded  size  of  message[e]  is  the  exploded  size  of 
message[e]  plus  the  size  of  update_message 
UNLOCK  temporary_message 
EXIT 


b.  Meta  Rules 


There  is  only  one  set  of  meta  rules  for  the  encode  delta  component(s).  This  set  is 
as  follows: 


time,  ^\1uch  all  messages  have,  field  code  2  means  track  number,  and  so  on.  The  special  code  of  XX 
means  that  this  is  the  beginning  of  a  new  message,  so  that  the  decoding  algorithm  will  start  looking  for  a 
sequence  of  field  codes  and  fields  for  the  new  message.  If  no  known  field  code  is  encountered,  then  the 
message  end  has  been  found.  Since  outgoing  messages  can  be  of  almost  any  length,  modulo  three  words. 
Agent  keeps  adding  updates  to  the  temporary  word  until  the  exception  handler  forces  it  to  be  output. 

The  code  for  simple  delta  messaging.  In  the  real  implementation,  “code  of  type”  should  be  used.  It  is 
given  explicitly  here  to  remind  the  reader  that  such  codes  are  arbitrary. 

“  All  delta  messages  begin  with  the  trio  of  type,  track,  and  update_time.  The  type  is  needed  to  know 
what  fields  to  look  for,  the  track  is  needed  to  match  up  with  previous  tracks,  and  the  update  time  will 
always  be  different.  Other  fields  are  added  only  if  different  fi-om  the  previous  update. 
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(LOOP  (FALSE(EVENT  (“terminate”))) 

( 

(GETFACTS  (“Agent  Status”)  (Status_facts)) 

(IF  (TRUE  (“strategy  of  Agent  is  simple  delta”)) 

( 

(INFER  0  (“deltaencode”)  (“OutFacts”)) 

)) 

(IF  (TRUE  (“strategy  of  Agent  is  extrapolation”)) 

( 

(INFER  0  (“extrapencode”)  (“OutFacts”)) 

)) 

) 

Any  additional  encoding  schemes  can  be  added  in  the  same  fashion  to  this  meta 
rule  base. 


2.  Decoder 


a.  Production  Rules — Routing  Messages 

IF  If  die  status  of  ANY  message  is  entry 

The  direction  of  THOSE  messages  is  right 
The  form  of  THOSE  messages  is  encoded 
THEN  Action  is  NULL 

ELSE  EXIT 

IF  The  encoding  scheme  of  ANY  message  is  simple  delta 

THEN  Action  is  process  delta  message 

IF  The  encoding  scheme  of  ANY  message  is  extrapolation 

THEN  Action  is  process  extrapolation®^ 

b.  Production  Rules — decoding  delta  messages 

The  following  will  decode  any  number  of  messages  encoded  with  so-called 

“simple”  delta  messaging.  The  name  of  the  base  is  “decodedelta” 

IF  If  die  status  of  ANY  message  is  entry 

The  direction  of  THOSE  messages  is  right 
The  form  of  THOSE  messages  is  encoded 

Note  that  ONLY  is  not  specified  in  these  cases.  We  are  checking  to  see  if  messages  of  either  or  both 
schemes  are  ready  for  decoding. 
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THEN  LOCK  ONE  of  THOSE  messages 

The  status  of  THAT  message  is  decoding 
&Name  is  NAME  (THAT  message)  ONLY 

ELSE  EXir* 

IF  FIELD  (string  of  $&name,  «&dpos,2)  is  “XX” 

THEN  &pos  =  &pos  +  2 

LOCKm 
m  =  m  +  1 
UNLOCK  m 
message[m]  is_a  message 

The  type  of  message[m]  is  FIELD  (string  of  &$name*’, 
&pos,  size  of  message_type) 

&pos  =  &pos  +  size  of  message  type 

IF  The  type  of  message[m]  is  J3.2 

THEN  message[&m]  is_a  J3.2 

DEINSTANTIATE  message[m]  FROM  message 
&interval  is  update  interval  of  J3.2  ONLY 

IF  The  type  of  message[m]  is  J3.3 

THEN  message[&m]  is_a  J3.3 

DEINSTANTATE  message[m]  FROM  message 
&mterval  is  update_interval  of  J3.3  ONLY 

IF  The  type  of  message[m]  is  J2.2 

THEN  message[&m]  is_a  J2.2 

DEINSTANTIATE  message[«S:m]  FROM  message 
&interval  is  update_interval  of  J2.2  ONLY 

WHILE  FIELD  (string  of  $&name,  &pos,  2)  not_equal_to  NULL 
BEGIN  Decoding 

IF  TRUE 

THEN  The  type  of  message[m]  is  FIELD  (string  of  message[&m], 

&pos,2) 

&pos  =  &pos  +  2 

The  update  time  of  message[m]  is  FIELD  (string  of 
message[&m],  &pos,  size  of  update_time) 

&pos  =  &pos  +  size  of  update  time 


“  If  a  message  to  process  isn’t  found  that  doesn’t  mean  there  was  an  error.  A  parallel  process  could  have 
picked  up  the  message  for  decoding  before  this  process  was  able  to  find  it. 

**  Evaluation  is  fiom  right  to  left.  So  that  first  the  parser  knows  that  it  is  a  local  variable,  second,  it  knows 
to  perform  substitution  on  it. 
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The  track  of  message[ni]  is  FIELD  (string  of  message[m], 
&pos,  size  of  track) 

&pos  =  &  pos  +  size  of  track 

IF  The  track  of  ANY  message  is  the  track  of  message[m] 

The  update_time  of  THAT  message  is  the  update  time  of 
message[m]  -  &interval 

THEN  #old_message  =  NAME  (THAT  message) 

ELSE  DEINSTANTIATE  message[m] 

Exn”" 

IF  FIELD  (string  of  message,  &pos,2)  is  lat  type 

THEN  &pos  =  &pos  +  2 

Lat  of  message[m]  is  FIELD  (string  of  message[m},  &pos 
+  size  of  lat,  size  of  lat) 

&pos  =  &pos  +  size  of  lat 

ELSE  Lat  of  message[m]  is  lat  of  #old_message 

IF  FIELD  (string  of  message,  &pos,2)  is  lon_type 

THEN  &pos  =  &pos  +  2 

Lat  of  message[m]  is  FIELD  (string  of  message[m},  &pos 
+  size  of  Ion,  size  of  Ion) 

&pos  =  &pos  +  size  of  Ion 

ELSE  Lat  of  message[m]  is  lat  of  #old_message 

IF  TRUE 

THEN  Direction  of  message[m]  is  left 

Status  of  message[m}  is  output 
LOCKf' 

J  =  J+1 
UNLOCK! 

MessageU]  is_a  raw_stream 

The  rawsize  of  message[j]  is  size  of  update 

The  time  of  messagejj]  is  the  update_time  of  message[m] 

END  Decoding 


This  is  an  error  exit,  in  that  the  previous  update  message  for  this  track  could  not  be  found.  Therefore 
we  can  only  drop  the  message  at  this  point. 

We’re  going  to  create  an  history  record  for  each  message  decoded.  This  will  be  used  in  calculating  the 
effective  bandwidth. 
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Meta  Rules 


The  following  meta  rules  for  decoding  call  knowledge  base 
“checking_for_messages”  to  determine  if  there  are  entry  messages  from  the  right  that 
need  to  be  decoded,  and  then  calls  the  knowledge  base  appropriate  for  the  decoding.  Any 
number  of  knowledge  bases  can  be  included  here.  Only  one  is  actually  documented  at 
this  point  (simple  delta  messaging). 

(LOOP  (FALSE(EVENT  (“terminate”))) 

( 

(INFER  0  (checking_for_messages)  (out_facts)) 

(IF  (TRUE  (“Action  is  process  delta  message”) 
(outfacts)) 

( 

(INFER  0  (“deltadecode”)  ()) 

)) 

(IF  (TRUE  (“Action  is  process  extrapolation”) 
(outfacts)) 

( 

(INFER  0  (“extrapdecode”)  (“OutFacts”)) 

)) 


D.  SHARED  COMPONENTS 

This  process  analyzes  net  loading  and  adjusts  the  strategy  of  Agent  accordingly. 
Every  time  a  message  is  sent  or  received  a  history  record  is  created  for  that  transmission. 
If  the  message  was  encoded,  the  raw  message  size  as  well  as  the  encoded  message  size  is 
included. 

The  first  step  is  to  prune  the  history  records  of  all  information  older  than  one 
frame.  The  next  step  is  to  determine  the  total  number  of  characters  (or  bits)  that  are  being 
transmitted  within  the  NPG.  If  this  number  is  higher  than  the  upper  trigger  level  (which 
is  set  as  a  result  of  laboratory  experiments),  delta  messaging  kicks  in.  When  it  falls  below 
the  lower  trigger  level,  delta  messaging  kicks  out.  These  changes  have  an  effect  only  on 
encoding.  Whenever  an  encoded  message  is  received  it  is  decoded  regardless  of  the  status 
of  Agent. 
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As  written.  Agent  kicks  in  or  out  based  on  NPG  loading.  It  is  possible  to  include 
node  loading  as  well,  with  an  appropriate  exchange  of  TIMs  and  TOMs  to  determine  the 
transmission  slots  available  to  the  node.  This  would  be  compared  with  its  output  loading 
to  determine  if  node  saturate  were  either  occurring  or  close  to  occurring.  If  so,  a 
reduction  strategy  would  be  enacted  for  this  node  (the  others  would  continue  to  operate 
according  to  their  information  about  the  NPG  and  themselves).  This  could  include  update 
rate  reduction  (which  would  be  handled  by  the  left  input  process,  vriiich  would  simply 
discard  updates  at  some  adjustable  rate  so  that  the  transmit  requirements  would  match  the 
transmit  capability). 
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V.  AGENT  METHODS  FOR  LINK  16 


INTRODUCTION 

For  this  project,  several  techniques  are  under  development  for  reducing  1)  the 
length  of  frequently-transmitted  messages  and,  2)  the  frequency  of  transmissions.  These 
techniques  are  lossless  in  that  there  is  no  concomitant  reduction  in  content  or  user 
situation  understanding.  These  techniques  are  under  development  for  initial  evaluation 
and  demonstration,  to  be  later  verified  in  the  NRaD  Systems  Integration  Facility  (SIF).  In 
the  SEF,  the  primary  purpose  of  establishing  key  benchmarks  is  to  assist  in  deciding 
between  alternative  object-oriented  (OO)  implementations.  Object-oriented  technology 
will  be  employed  as  much  as  practicable  in  this  demonstration.  Irrespective  of 
programming  style,  benchmarks  will  establish  the  best  possible  methods.  Therefore,  the 
prototypes  may  contain  a  mix  of  OO  and  procedural  components.  The  benchmarks  will 
reveal,  for  each  techmque,  the  best  possible  gain  in  virtual  bandwidth. 

Simultaneously,  a  software  agent  will  be  designed  to  further  reduce  bandwidth  by 
adding  intelligent,  distributed  link  control,  as  well  as  to  enhance  the  message  length- 
reduction  strategies  with  such  techniques  as  transmission  frequency  reduction.  As  stated 
earlier,  die  name  for  this  agent  is  “Agent.”  Software  agents  have  been  shown  to  be 
especially  useful  for  network  management  in  other  contexts.  The  rules  of  the  link  will  be 
instantiated  in  Agent,  vvdiich,  along  with  an  automated  transmission  planning  capability, 
can  provide  substantial  gains  in  virtual  bandwidth. 

ATOMIC  DATA  ELEMENT  TRANSMISSION  (“DELTA  MESSAGES”) 

In  this  techmque,  redundant  elements  of  messages  (e.g.,  track  update  messages) 
will  be  reduced  to  a  minimum.  In  general,  only  the  elements  of  a  message  that  have 
changed  since  the  last  update  will  be  transmitted,  together  with  identifying  information. 
The  goal  is  to  provide  a  decrease  of  one-third  to  two-thirds  bandwidth  requirements  for 
track  messages,  in  addition  to  only  transmitting  such  Delta  Messages  when  new 


information  deviates  outside  expected  parameters  as  determined  by  relative  navigation 
models,  see  Extrapolation-Driven  Updates,  below.  The  effective  reductions  would  make 
much  needed  bandwidth  available  for  other  purposes,  plus  increase  the  links  overall  track 
handling  capabilities  through  being  able  to  identify  and  update  a  greater  number  of 
tracks. 

If  the  OODBMS  chosen  by  other  parts  of  the  RTR  program  becomes  the 
bottleneck  in  the  process,  message  objects  with  strong  real-time  requirements  will  be 
cached  in  RAM,  or  other  strategies  developed,  to  enable  the  system  to  keep  up  with  the 
link  requirements. 

Figure  23,  Physical  Implementation,  describes  how  the  smart  agent  will  fit  into 
the  existing  system.  Details  of  the  operations  of  Agent  are  described  in  a  previous 
section. 


93 


C2P 


TAG  “X” 

TACTICAL  PICTURE 


Track 

Tables 


Time 

Synchronization 

Generator 


Large,  High-Speed 
Storage 


Figure  23,  Physical  Implementation 


Figure  24  shows  a  conceptual  view  of  delta  message  reduction.  Figure  24  shows 
the  type  of  information  a  delta  message  may  contain.  Although  the  TADIL  message  type 
is  “Free  Text,”  a  message  type  local  to  Agent  will  be  within  the  message,  for  each  type  of 
message  it  transmits.  Following  the  message  type  is  an  indicator  of  the  number  of  fields 
present  for  that  particular  message  type.  After  that  is  a  variable  number  of  fields  with 
field  types  (i.e.  integer,  character,  binary,  etc.)  associated  with  the  message  type. 
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Although  most  fields  are  fixed-length,  some  will  be  variable.  For  example,  with  respect 
to  latitude,  although  a  full  update  message  has  new  data,  probably  only  a  very  few  of  the 
least  significant  bits  from  the  previous  update  have  changed.  Agent  will  identify  and 
insert  the  changed  bits,  and  the  field  length  will  be  the  number  of  them.  The  receiving 
Agent  will  know  to  replace  the  lower  order  bits  from  the  previous  message  with  the  new 
ones.  Of  course,  if  the  whole  field  changes,  then  the  whole  field  will  be  sent.  It  is 
imderstood  that  if  there  is  significant  change  in  the  original  TADIL  message,  the  delta 
message  could  be  significantly  longer  than  the  original  message.  The  implication  is  that 
the  delta  message  is  checked  agianst  the  original  message  size.  Only  the  shorter  of  the 
two  is  sent. 

That  this  kind  of  severance  system  can  be  introduced  has  already  been  proven 
with  the  Link  16  virtual  gateway,  which  today  provides  both  a  passive  tap,  for  relaying 
the  tactical  picture  to  other  systems,  and  the  ability  to  insert  messages  directly.  Agent 
will  build  upon  the  structure  of  Galaxy. 


Figure  24,  Conceptual  Implementation 
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Some  types  of  messages  internal  to  Agent  will  be  control  messages  not  directly 
related  to  existing  message  types. 

The  many  different  link  messages  will  be  surveyed  for  their  applicability  to  this 
type  of  length-reduction  technique. 

One  challenge  is  that,  at  present,  track  update  messages  belong  to  the  surveillance 
NPG,  which  is  connected  to  one  of  only  three  existing  JTIDS  buffers.  The  buffer  is  there 
to  ensure  that  all  messages  of  the  surveillance  type  will  be  transmitted  (in  overload 
conditions,  a  message  not  buffered  can  be  tacitly  dropped  from  the  system).The  C2P 
manages  itself  based  upon  the  available  buffer  size.  At  present,  free-text  messages  do  not 
belong  to  the  surveillance  NPG.  The  poses  no  problem  for  the  benchmark  demonstrations 
because  there  is  an  operator-assignable  buffer  that  can  be  used.  For  the  long  term,  a  plan 
will  be  created  for  either  1)  including  the  free-text  message  in  the  surveillance  NPG,  2) 
assigning  a  buffer  to  the  free-text  messages,  or  3)  simulating  buffer  operations  within 
Agent. 
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From  what  is  known  at  the  time  of  this  writing,  the  best  answer  is  to  have  free- 
text  messages  included  in  the  surveillance  NPG,  which  would  cause  a  small  modification 
to  the  C2P’s  buffer  size  prediction  algorithms  (JTIDS  would  look  more  efficient  to  the 
C2P  than  it  does  today). 

C.  UPDATE  BUNDLING 

Not  all  frequently-transmitted  messages  are  of  high  priority.  Also,  the  priority  of 
a  given  type  of  message  may  vary  with  die  situation.  Delta  messages,  or  other  types  of 
messages,  can  be  bundled  into  a  single  transmission  using  the  free-text  message  format. 
This  would  make,  for  example,  the  transmission  of  historical  track  data  feasible  (by 
encapsulating  a  full  message  and  all  of  the  subsequent  updates  into  a  single  free-text 
message).  Because  all  of  the  information  is  in  a  single  message,  rather  than  in  many 
messages,  the  system  may  be  able  to  process  the  information  more  efficiently  (that  is,  the 
total  package  of  information  is  received  more  quickly,  and  less  administrative  load  on  the 
system). 

To  minimize  this  overhead,  another  function  might  be  to  “bundle”  a  historical 
message  with  all  its  subsequent  delta  messages,  so  that  a  platform  entering  the  network 
could  be  updated  on  all  of  the  data  concerning  a  particular  track  in  a  single,  free-form 
transmission  of  minimal  size. 

In  today’s  system,  it  is  a  goal  that  all  track  updates  be  sent  within  twelve  seconds. 
This  is  true  for  slowly-moving  objects,  such  as  ships,  and  faster-moving  objects,  such  as 
airplanes.  Resources  permitting,  delta  messages  from  slower-moving  objects  would  be 
“packed”  as  in  figure  4  above,  for  transmission  in  a  single  message  after  a  fixed  interval 
(TBD).  At  die  receiving  end,  all  of  the  updates  would  be  applied  with  Agent,  with  the 
resulting  full  update  message  being  sent  on  to  the  C2P. 

It  is  important  to  validate  bundling  as  a  concept.  This  means  that  in  the  SIF,  the 
total  network  loading  of  sending  multiple  small  messages  must  be  compared  to  the 
loading  from  sending  one,  larger  message.  Network  performance-measuring  toots 
ciurently  being  developed  by  others  will  be  used  to  measure  the  expected  gain.  Since  it  is 
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estimated  that  network  bookkeeping  amounts  to  some  twenty  percent  of  net  loading,  the 
gain  promises  to  be  significant. 

This  task  will  be  coordinated  with  task  4.2.5,  Active  Network  Management,  in 
order  to  implement  variable  packing.  For  example,  packing  parameters  can  be  altered,  or 
packing  completely  eliminated,  as  the  tactical  picture  changes. 


D.  EXTRAPOLATION-DRIVEN  UPDATES 

In  this  technique,  each  type  of  vehicle  being  tracked  is  modeled  on  every 
platform,  utilizing  a  flat  Earth  3-D  model  (dead  reckoning).  Each  platform  makes  a 
projection  of  the  tracked-vehicle’s  position  at  its  next-scheduled  update  cycle,  based  on 
observed  behavior.  If  the  predicted  position  is  close  enough  to  the  actual  position,  then 
either  no  transmission  is  made  and  the  individual  Agents  generate  the  update  locally,  or  a 
very  small  transmission  is  made  confirming  that  the  prediction  is  accurate.  If  too  great  a 
deviation  has  occurred,  then  a  full  update  message  or  a  delta  message  is  actually 
transmitted.  Since  most  tracked  vehicles  behave  predictably  over  short  intervals,  this 
technique  promises  to  greatly  reduce  network  loading— with  no  loss  of  information  at  the 
receiving  platforms. 

At  any  given  time,  one  platform  has  the  reporting  responsibility  for  a  given  track 
(based  on  track  quality).  The  concept  of  extrapolation-driven  updates  is  to  have  a  set  of 
vehicle  simulations  at  each  platform  that  predict  the  position  of  the  tracked  vehicle  at  the 
next  scheduled  update.  If  the  prediction  of  the  update  matches  the  reported  “true” 
position,  Avithin  an  appropriate  tolerance  (calculation  based  upon  range  and  sensor 
resolution),  no  update  would  be  sent.  Instead,  Agent  would  internally  generate  an  update 
message  based  on  its  prediction  and  send  that  update  to  die  C2P.  The  concept  is 
illustrated  in  Figure  26. 


98 


Figure  26 


The  shape  and  size  of  the  error  tolerance  is  determined  by  the  vehicle  type, 
elapsed  time,  and  the  accuracy  of  the  sighting  information.  For  example,  if  the  gaussian 
circular-error-probable  (CEP)  of  the  sighting  is  known,  the  circular  coverage  function 
can  be  used  to  determine  if  the  sighting  is  within  a  particular  level  of  assurance  of  a 
circular  tolerance  shape.  See  Figure  27.  In  the  process,  the  total  probability  distribution 
within  the  circle  is  integrated.  If,  say,  a  ninety  percent  assurance  is  required,  then  ninety 
percent  of  the  distribution  must  lie  within  the  circle.  If  so,  no  message  is  sent.  The 
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automatic  curve  fitting  mechanism  then  adjusts  to  the  new  position,  recalculates  the  error 
shape,  and  continues.  If  not,  the  actual  position  is  sent  and  the  curve  fitting  adjusted. 

A 


A  =  actual  sighting 
P  =  predicted  sighting 

Figure  27,  Assurance  Calculations 

The  problem  of  predicting  a  location  based  on  historical  track  information  is  non¬ 
trivial.  Agent,  for  example,  will  have  to  know  when  a  sighting  is  clearly  improbable,  and 
thus  in  error,  so  that  it  can  be  tacitly  discarded.  While  for  short  intervals  a  linear 
prediction  may  be  useful,  for  longer  intervals  a  more  complex  prediction  algorithm  must 
be  employed.  One  important  study  to  be  performed  in  the  out  years  will  be  to  determine 
the  best  prediction  algorithms  to  employ.  A  fixed  circle  will  be  used  as  the  error 
tolerance,  along  with  a  linear  curve  fit  with  zero  uncertainty.  However,  this  will  by  no 
means  demonstrate  the  potential  effectiveness  of  the  extrapolation  technique. 
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E.  TRADITIONAL  COMPRESSION 


If  the  targeted  processor  can  keep  up  with  the  data  rate,  a  loss-less  compression 
technique,  such  as  Lempel-Ziv,  can  be  applied  to  lengthy  messages.  The  messages  will 
be  examined  for  good  candidates  for  this  type  of  compression,  and  estimates  of  the  time 
necessary  for  the  various  algorithms  to  perform  the  compression  will  be  estimated.  When 
resources  permit,  an  attempt  to  establish  a  benchmark  for  this  type  of  compression  will 
be  made  in  the  SIF. 

With  respect  to  video  and  voice,  at  this  point  it  is  believed  that  hardware 
assistance  will  be  required  for  compression/decompression.  This  task  is  therefore  limited 
to  identifying  all  of  the  platform  types  that  can  be  connected  to  the  link,  and  determining, 
to  the  extent  information  is  available,  if  COTS  compression  boards  are  available  for  these 
platforms,  or  will  be  available  within  a  reasonable  time  span. 

F.  EXTENSIONS 

The  immediate  ^plication  is  to  reduce  die  amount  of  redundant  information 
transmitted  over  the  link  (see  individual  tasks  below).  However,  additional  autonomous 
agent  functions  could  help  to  better  manage  the  tactical  links  by  detecting  problems  and 
taking  steps  to  alleviate  the  consequent  load  on  the  net,  when  possible  and  acceptable. 

The  initial  analysis  and  design  of  the  intelligent  agent  architecture  will  also  be 
directed  towards  meeting  the  system  requirements  for  robusmess  in  the  face  of 
communications  gaps  or  failures.  The  architecture  provides  significant  oppKJitunity  for 
extension.  Out  year  tasks  will  develop  agents  that  manage  other  types  of  messages, 
support  recognition,  routing  and  processing  of  new  RTR  message  types,  and  call 
attention  to  messages  requiring  quick  reaction. 

Over  the  course  of  this  work  and  subsequent  efforts,  all  message  types  will  be 
examined  for  ways  in  which  a  intelligent  agent  could  optimize  network  operations. 
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This  effort  will  include  interviews  of  expert  users  of  the  system  in  an  effort  to 
collect  additional  cases  or  flmctions  that  are  appropriate  to  intelligent  agent  action,  and 
where  appropriate  seek  to  incorporate  this  in  the  current  network  schema. 
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VI.  SUMMARY 


A.  WORK  ACCOMPLISHMENTS 

1.  The  engineering  design  of  Agent  has  been  documented  to  die  point  where 
detailed  design  can  use  it  as  a  guide. 

2.  All  of  the  software  and  ftmctional  requirements  of  Agent  are  satisfied  by  this 
design. 

3.  The  Agent  engineering  design  is  not  specific  to  Link- 16  or  any  other  tactical 
network. 

4.  Agent  is  compatible  with  a  multi-processor  implementation,  but  can  run  on  a 
single-processor  machine. 

5.  Agent  has  its  own  inference  engine,  the  special  features  of  which  are 
described  in  detail. 

6.  Agent  is  otherwise  compatible  widi  IBM’s  Agent  Building  Environment 
(ABE).  During  detailed  design,  another  took  kit  can  be  substituted  if  found  to 
be  more  appropriate. 

B.  WORK  TO  BE  DONE  IN  SUBSEQUENT  PHASES 

1.  Make  sure  that  the  rule  bases  are  thoroughly  debugged,  especially  with 
respect  to  NPG  loading  calculations.  Construct  a  test  bed  in  SNOBOL  for 
this  purpose. 

2.  Add  rules  for  calculating  node  loading. 

3.  A  low-level  briefing  on  the  engineering  design  should  be  written. 

4.  The  low-level  briefing  should  provide  the  basis  for  a  conference  to  discuss 
the  engineering  design  among  the  interested  parties. 

5.  Add  formal  BNF  to  describe  the  facts  and  rules.  Formalize  the  otherwise 
informal  notations  used  in  this  dociunent. 

6.  Create  rules  for  passive  net  normalization. 
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7.  Create  rules  for  agent-to-agent  “update  me”  messages  for  active 
normalization. 

8.  Insert  sequence  numbers  into  encoded  messages  (quasi  token  ring  scheme)  so 
that  receiving  nodes  can  detect  missing  updates. 

9.  Agent  as  written  does  not  compare  actual  net  loading  with  predicted  net 
loading  in  order  to  do  a  kind  of  “sanity  check”  on  its  own  operations.  This 
can  be  added. 

10.  Encode  and  Decode  rule  bases  for  other  heuristics  need  to  be  written. 

1 1.  A  high-level  briefing  on  die  engineering  design  should  be  written. 

12.  A  low-level  briefing  on  the  engineering  design  should  be  written. 

13.  A  command-level  briefing  on  Agent  should  be  written. 

14.  At  some  point  before  detailed  design,  a  survey  of  inference  engines  should  be 
made  to  see  if  any  are  close  enough  to  Agent  requirements  to  be  used  as  a 
point  of  departure. 

15.  At  some  point  before  detailed  design,  a  survey  of  agent-building  toolkits 
should  be  made. 
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VII.  FUTURE  WORK 


Today’s  Link  16  is  passive,  for  the  most  part  requiring  acknowledgments  only  for 
certain  types  of  messages,  such  as  military  orders.  However,  with  Agent  in  place,  and 
Agent-to-Agent  communications  demonstrated,  more  complex  ways  of  fine-tuning 
network  operation  are  possible.  In  an  example  mentioned  above,  a  platform  could  request 
complete  historical  information  on  a  specific  track,  and  receive  that  information  in  an 
efficient  maimer.  Also,  the  fi-equency  of  updates  could  be  controlled  by  the  individual 
needs  of  the  receiving  platforms,  with  the  platform  requiring  file  most  urgency  receiving 
priority.  Network  optimization,  while  nevertheless  working  within  today’s  rules  and 
restraints,  can  be  an  operational  reality. 

In  the  out  years,  an  attempt  will  be  made  to  quantify  the  gain  expected  fi-om 
allowing  the  Agents  to  communicate  with  each  other,  whereby  they  adjust  network 
parameters  in  real  time.  For  an  example  involving  considerable  intelligence,  update  rates 
could  be  dynamically  adjusted  by  the  situational  assessment  of  the  importance  of  a  track 
relative  to  the  tactical  situation.  This  is  a  significant  step  towards  more  autonomous 
functionality  based  on  an  agent’s  own  situation  assessment. 

Additional,  more  ^cialized  agents  may  contain  user-specific  knowledge.  For 
example.  Agent  could  passively  notify  the  special  agent  of  events  as  they  occur,  and  the 
special  agent  could  provide  various  types  of  amplifying  information  to  the  console  user 
based  upon  the  operator’s  needs.  The  specialized  agent  may  be  capable  of  a  range  of 
responses,  fi'om  simple  alert  messages  to  action  sequences. 

In  the  case  of  urgency-driven  updates,  the  receiving  platforms  would  examine  the 
current  rate  at  which  a  given  track  was  being  updated,  and,  if  satisfactory,  do  nothing.  If 
a  hi^er  rate  of  iqniate  is  desirable,  a  Agent  to  Agent  message  is  generated  that  increases 
the  update  rate.  In  this  way,  update  rates  coiild  be  drive  up  or  down  based  upon  the 
perceived  tactical  situation.  A  very  intelligent  and  platform-specific  Agent  could  do  this 
function  transparently. 

Ideally,  Agents  would  utilize  a  CORBA-compliant  object-request  broker  (ORB), 
such  as  Iona’s  ORBIX,  or  possibly  incorporate  the  JAVA  applet  to  application 
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architecture,  to  transparently  manage  track  updates  (and,  indeed,  all  message  objects). 
Each  C2P  would,  under  an  ORB,  appear  to  have  all  track  objects  present  in  its  own 
address  space,  regardless  of  where  on  the  link  they  actually  resided.  Then,  rather  than 
transmit  at  fixed  intervals,  platforms  could  simply  examine  the  track  objects  at  whatever 
frequency  is  thought  to  be  important.  This  would  reverse  the  idea  of  the  link — from 
fixed-interval  transmission  to  as-needed  query.  The  ORB  would  ensure  that  the  data  was 
current.  Figure  7  shows  a  layered  view  of  a  component-based  architecture. 


Agent  Domain  Classes 


Orb  Services 


Namina  Events  Query  Tiadeil.ire  Socuriifin  ColloctiDB<<t„»,iKu» 

bxtenidficliajlaousliipstmcunem  V'lransactioDS  Mano  cement 

teroneranilil  V  _ — _ — _ - _ — 


Data  Repository 


Figure  28,  Orb-Based  Architecture 
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As  attractive  as  the  use  of  an  ORB-based  system  is,  the  current  overhead  of  an 
ORB  constitutes  a  significant  chunk  of  bandwidth  and  may,  with  today’s  technology, 
slow  down  real-time  processing,  precluding  its  use  in  this  context.  The  key  to  the 
analysis  is  at  the  system  level,  not  at  the  link  level. 

Beyond  the  applicability  to  military  communications,  such  technology  has 
obvious  implications  with  respect  to  commercial  communications  networks 
(INTERNET,  or  any  other  digital  communications  network).  While  it  is  acknowledged 
that  the  development  of  an  agent  architecture  is  not  ’"the  solution”,  it  has  the  potential  to 
alleviate  already  crowded  communications  lines,  while  not  sacrificing  accuracy.  The 
robustness  of  such  an  approach  has  not  yet  been  adequately  determined.  However,  it  is 
felt  by  the  author  that  such  an  approach  will  provide  for  more  optimized  network 
utilization  of  available  assets  (bandwidth),  ultimately  resulting  more  efficient  and  overall 
faster  network  operations. 
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APPENDIX 

CONCEPTUAL  PROTOTYPE  SOURCE  CODE 

Note  -  This  prototype  was  developed  utilizing: 

•  Intel  Pentium  166Mhz  processor 

•  Windows  95  OS 

•  Rogue  Software  gui  builder  and  TCP/IP 
sockets  development  packages 

•  Borland  C++  version  4.5 1  compiler 

Copyright  material  (header  files  included  with  the  above  build  packages)  are 
omitted. 


typedef  void  (♦  ENTRYXvoid  *); 
class  CScrvicel 


m__ServiceName; 

m_ExitEvent; 

m^ServiceStatusHandle; 

in_PauseService; 

m_RunningService; 

m_ThreadHandIe; 


private: 

LPSTR 

HANDLE 

SERVICE^STATUS^HANDLE 

BOOL 

BOOL 

HANDLE 
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ENTRY 


m_Entry  Function; 


int 

m_Start'nmeOut; 

int 

m_StopTimeOut; 

int 

m_PauseTuneOut; 

int 

m^ResumeTimeOut; 

void  OnPauseServiceO; 
void  OnResumeServiceO; 
void  OnStopServiceO; 
long  OnStartServiceO; 

static  VOID  ServiceMain{DWORD  argc,  LPTSTR  *argy); 

BOOL  SCMStatus  (DWORD  dwCurrentStateJ)WORD  dwWin32ExitCode, 

DWORD  dwServiceSpecificExitCodeJDWORD  dwCheckPoinUDWORD  dwWaitHint); 

static  VOID  ServiceCtrlHandler  (DWORD  controlCode); 

VOID  Exit(DWORD  error); 


//install  variables 
DWORD  m_dwDesiredAccess; 
DWORD  m__dwServiceType; 
DWORD  m_dwStartType; 
DWORD  m^dwErrorControl; 

LPSTR  m_s2LoadOrderGTOup; 
LPDWORD  mlpdwTagID; 
LPSTR  m^szDependencies; 


public: 

CServiceQ; 

-OServiceO; 


//service  entry  point 

long  InitService(LPCSTR  name, void  *  EntryFunction); 

//service  timeout  settings 
int  SetStaitTimeOut(int  milisec); 
int  SetStopTlmeOu^int  milisec); 
int  SetPause'nmeOut(int  milisec); 
int  SetResumeTimeOut(int  milisec); 


//service  install  /  un-install 


int  SetInstallOptions(DWORD  dwDesiredAccess,  DWORD  dwServiceType, 

DWORD  dwStartTypeJ^WORD  dwErrorControl); 
int  SetInstallOptions(LPSTR  szLoadOrdeiGroup  JLPDWORD  IpdwTagID, 


LPSTR  szDependencies); 


int  InstallService(LPCSTR  szIntemName  J-PCSTR  szDispIayNameJLPCSTR  szFullPath); 
int  InstallServicc(LPCSTR  szIntemNameXPCSTR  szDisplayNameXPCSTR  szFullPath, 

LPCSTR  szAccountName  J-PCSTR  szPassword); 

int  RemoveService(LPCSTR  szIntcmName); 


}; 


#include  "zappJipp" 

#include  "mdiappJipp"  //  Main  App  Qass  Definitions  &  Includes 

ZAPP^IMPL^ASSERTS 

//  zpb^begin  GlobalVars 
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HWNDstatus__hWnd; 
char  $tufT[LBUFSZ]; 


char  ♦DxBufIDXBUFSZ]; 
int  DxBufInp; 
int  DxBufNdx; 

// 

//  SlpQ  is  an  object  which  allows  independent  execution  of  member 
//  functions. 

// 

class  SlpQ  { 

#define  NTASKS  50 
unsigned  long  SITm[NTASKS]; 
unsigned  long  WkTmfNTASKS]; 
zMDIChildFrame  ♦sq[NTASKS]; 

public: 

SipQO; 

-SlpQO; 

unsigned  long  systime; 

int  Slp(zMDIChildFrame  unsigned  long); 

int  CkQO; 

int  Rni(zMDIChiIdFrame  ♦); 

}y/end  SlpQ 


DWORD  WINAPI  ThreadFunc(LPVOID  IpvThreadParm);  //forward  reference 
SlpQ  *pSQ;  //pointer  to  the  sleep  queue 
//  end  sleep  queue  parameters 


//  Track  Class  Declaration 

f!  **«««*««««»»,*»*«*»**^***«« 

#define  MXTKMS  10000 
#dcfineMXTKPTS24 
#defineHOSTn-E_AIR  0 
#defincHOSTILE_SUB  1 
#dcfine  HOSTILE^^SURFACE  2 
#define  UNKNOWN_AIR  3 
#define  UNKNOWN_SUB  4 
#dcfine  UNKNOWN^SURFACE  5 
#define  FRIENDLY 6 
#dcfine  FRIENDL  Y_SUB  7 
#define  FRIENDL  Y_SURFACE  8 


class  Tik  { 
public: 

TrkO; 

-TfkO; 
tntupdO; 
intdmsgO; 
int  type; 
intnum; 
int]q>os; 
tntypos; 
imxvec; 
intyvee; 
float  ahRaw; 
float  xRaw; 
float  yRaw; 
float  spRaw; 
float  xdRaw; 
float  ydRaw; 
zColor  cir, 
chartimStr[16]; 
char  typStr[8]; 
char  strStr(32]; 


//update  die  track  info  for  display  purposes 
//delta  message  method 
//type  of  track 
//track  number 

//current  x  location  for  display  on  track  window 

//••y*  m  m  m  m  m 

H  X  location  of  track  vector  endpoint 

//y . 

//  raw  altitude  value  directly  converted 
//  raw  coordinate  value 
//  raw  coordinate  value 
//  raw  speed  value  direedy  converted 
//  raw  delta  of  coordinate  value 
//  raw  delta  of  coordinate  value 
//color  of  display  is  initially  white 
//timestamp  is  die  string  direedy  j5t>m  the  msg 
//type  of  track 
//undefined  characters 
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char  nuinStr[8];  //track  number 

char  romStr[LBUFSZ];  //rest  of  message  string 

char  OIdMsg[LBUFSZ];  //Old  Message  as  copied  directly  out  of  buffer 

char  CurMsg[LBUFSZ];  //New  *•  ”  "  «  «  «  « 

int  01dDel[LBUFSZ];  //Changed  symbols  for  old  message 

int  CurDeI[LBUFSZ];  //Changed  symbols  for  current  message 

int  MQndx;  /^idex  to  the  latest  entry  in  MQ 

char  *MQ[MXTKMS];  //message  buffer  for  this  track 

int  cCnt[MXTKMS];  //symbol  count  per  message,  i.e.  length 

int  dCnt[MXTKMS];  //diff  value  count  between  messages 

float  csRatio[MXTKMS];  //ratio  of  diff^total  count 

WDatAn  ♦AnWn;  //Analysis  window  for  Track  Txt  window 

WTrkTxt  *TxWn;  //this  is  a  text  window  for  the  message  buffer 

int  distype;  //this  is  a  unknown  of  display  bitm^ 

char  dTypStr[64];  //string  for  the  type  of  displayed  icon 

};//endTrk 

// 

//  Track  Queue  Class  Declaration 

// ♦♦♦***♦*♦♦*♦**♦♦**♦♦♦♦*♦♦♦♦ 

#define  MAXTRKS  400  //Maximum  number  of  tracks  per  Q 

class  TrkQ  { 

public: 

Trk  *TQ[MAXTRKS];  //Array  of  Pointers  to  Tracks 

Trie  ♦newTrk;  //reserve  track 

int  nTrks;  //number  of  tracks  in  the  queue 

int  DTmdx;  /rindex  for  the  track  information  dialog 

int  newTrkTxt;  //index  for  text  message  display  for  tracks 

int  xdTricTxt;  //x  offset  for  new  TricTxt  window 

int  ydTrkTxt;  //y  offset  for  new  TrkTxt  window 

int  newTricAn;  //index  for  the  track  analysis  window 

TrkQO; 

-TrkQO; 
int  upd(char  ♦); 

float  minlg;  //this  is  for  display  coordinates 

float  maxlg; 

float  dellg; 

float  minlt; 

float  maxlt; 

float  dellt; 

int  nnvfzString  ♦);  //removes  the  track  in  the  message  string 
int  rescaleQ;  //resets  the  display  coordinates 
//Trk  •pctric;  //global  (common)  ptr  to  a  current  DTInfo  Trie 

};//endTricQ 

//  *•«•««««**•*«**»•***,«,«*«» 

//  Code  Book  Class  Declaration 

If  *»•««***«*«««**««***««,,«•« 

#defineMAXFMTS32 
#dcfineMAXFLDS  32 
classCdBkf 
public: 

CdBkO; 

-4:dBkO; 

int  fint[MAXFMTS]; 
zString  ♦flds[MAXFLDS]; 

};//end  CdBk  Class  Declaration 


//  «*•**«***»**«**«*<«*«««,*»«* 

//  Track  Methods 

Trk::TrkO{ 

type  =  0;  //type  of  track 

num  =  0;  //track  number 


116 


xpos  =  0;  //current  x  location  for  display  on  track  win 

ypos  =  0;  //  "  y . . 


clr  =  WHITE;  //color  of  display  is  initially  white 

distype  =  UNKNOWN_SURFACE;  /^tialized  of  bitm^  is  unknowtype 

strcpy(dTypStr,"Unknown  Surface");  //string  for  the  type  of  icon  displayed 

strcpy(  timStr,"");  //timestamp  is  the  string  directly  from  Ae  msg 

strcpy(  typStr,"");  //type  of  track 

strcpy(  strStr,"");  //undefined  characters 

strcpy(  numStr,"");  //track  number 

sticpy(  romStr,"");  //rest  of  message  string 

strcpy(  OldMsg,"");  //Old  Message  as  copied  directly  out  of  buffer 

strcpy(CurMsg,"");  //New  "  «  . 

MQAdx  =0;  /Aidex  to  Ae  latest  entry  in  MQ 

int  ndx;  //tmp  index  for  for>loop 

foi(ndx=0;ndx<MXTKMS;ndx-H-)  { 

MQ[ndx]  =  NULL;  //message  buffer  for  Ais  track 
}//endfor 

TxWn  =  NULL;  //Ae  text  display  window  is  initially  NULL 

}//end  Trk  constructor 


Tric::-TrkO{ 

}//end  Trie  destructor 

int  Trk::updO {  //update  Ae  particular  track 
return  0; 

}//end  Trk  update 


int  Tric::dmsgO  { 

//local  constants 

#define  N__TKMSGS  24  //  total  number  of  messages 


//local  variables 

int  tmp^ndx;  //temporary  index 

int  IbufNdx; 

irmt  r_curr  =  MQndx;  //actual  index  into  Ae  buffer  of  messages 


char^ptcl; 
char  ♦ptcO; 
char  *ptcml; 

int  numchrs; 
int  ndx; 
intdsum; 

int  scntpLBUFSZ]; 
char  neAuffLBUFSZ]; 

if(MQndx>2)  {  //we  need  tiiree  messages  for  delta  messaging 
ptcl  =  MQ[MQndx-l  ];  //get  pointer  to  message 
ptcO  =  MQ[MQndx-2]; 
numchrs  =  strien(ptcl); 
dsum  =  0; 
int  cent; 

foi(ccnt=0;(ccnt<numchrs)&&(ccnt<LBUFSZ);ccnt++)  { 

if((*ptcl)!-CptcO)){ 

$cnt(ccnt]  «  1 ; 

CurDel[ccnt)  =  I; 

dsum-H-;  //tiiis  counts  number  of  chars  not  same 
}else{ 

scnt[ccnt]  =0; 

CurDel[ccnt]  =  0; 

}//enAf 

ptCl-H-; 

ptc(H-»-; 

}//endfor 

ptcO  =  MQ[MQndx*2];  //reset  pointer  to  line  buffers 
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ptcml=MQ[MQndx-3]; 

for(ccnt=0;(ccnt<numchrs)&&(ccnt<LBUFSZ);ccnt-H-){ 

if((*ptcO)  !=  (♦ptcml)){ 

01dDel[ccnt]  =  1; 

}else{ 

OIdDeI[ccnt]  =  0; 

}//endif 

ptc(H-f; 

ptcinl++; 

}//endfor 

//following  section  of  code  is  an  initial  preliminary  coding 
//for  run  length  encoded  "delta  messages" 

//note  that  the  major  problem  for  this  is  that  the  overfiead 
//greatly  reduces  the  number  of  symbols  saved. 

//run-length  encoding  is  currently  turned  off, 

#define  MXCHGS  10 
#defineMXRN  16 

int  dmsg[MXCHGS];  //=  {0,0,0, 0, 0,0,0, 0,0,0}; 

int  dmsgndx  =  0;  //  test  to  see  if  we  have  a  delta  message 

int  tmdel  =  strIen(timStr)  +  1 ; 

int  oldccnt; 

for(ccnt=tmdel; 

((ccnt<numchrs)&&(ccnt<LBUFSZ)); 
ccnt++  ){ 

if(  (  CurDelfccnt]  =  1  )  //we  have  a  new  char 

&&(  01dDel[ccnt]  =  0 ))  {  //no  delta  message 
oldccnt  =  dmsg[dmsgndx]; 
dmsg[dmsgndx]  =  cent; 
if(dmsgndx<MXCHGS)  { 
dmsgndx-H-; 

}//endif 

}//endif 

}//endfor 


ptcl  =  MQ[MQndx-l];  //reset  pointer  to  curr  buffer 
ptcl  +=  tmdel; 

if(dmsgndx  <=  0){  //we  have  a  delta  message 

int  ntbfiidx  =  0; 
inttndx; 


foi(tndx=0;tndx<dnisgndx;tndx-H-)  { 
netbuf[ntbfiidx]=  (♦(ptc  1  -i-dinsg[tndx])); 

ntbfadx++; 


}//endfor 


netbuf[ntbfiidx]  ~ '!’; 

nti)fedx-H-; 

for(ccnt=tmdeI; 

(ccnt<numchrs)&&(ccnt<LBUFSZ); 
cent^H-  ){ 

if(  OidDel[ccnt]  =  1 ){  //delta  char 
ned>uf[nd)&dx]  =  ♦ptc  1 ; 
ntbfiidx++; 

}//endif 

ptcH-+; 

}//endfor 

netbuf[ntbfiidx]  =  *\0'; 


//the  following  for  loops  are  here  because  extraneous  characters 
//were  in  the  resultant  string  if  the  strxxxQ  routines  are  used 
//also,  if  stmepyQ  is  used  instead  of  strepyQ,  very  strange 
//looking  oversized  strings  were  created,  ???  library  or  compiler  ??? 

chardmbufILBi;FSZ]  =  " 

//strcpy(dmbuf;timStr); 
int  tmpndx; 

for(tmpndx=0,'tmpndx<12;tmpndx-H-)  { 
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(♦(dmbuf+tmpndx))  =  (*(timStri-tmpndx)); 

}//en<ifor 

//strcat(dmbuf4iumStr); 
foi<tmpndx=0;tmpn(ix<3;tmpndx++)  { 

(♦(dmbuf+12+tmpndx))  =  (♦(numSliH-tmpndx)); 

}//endfor 

//strcat(dmbuf4ietbuf); 

for(tnipndx=0;tmpn<^<=ntbfiidx;tmpndx-H-)  { 

(♦(dmbuf+1 5+tmpndx))  =  (♦(netbuf+tmpndx)); 

}//endfor 

//the  following  sends  a  track  update  message  to  the  other  machine 
C_WSClient  client;  //create  the  object  RTRclient 
if  (clientConnect(79,"128.49.133.12")  !=  WSC__SUCCESS) 
MessageBox(NLJLL,"Connection  Fair,"  "Affi_OK); 

//endif 

clientSend(dmbuf); 

clientSend("\r\n"); 

clientCloseConnectionO; 


}  else  {  //send  raw  message 

//the  following  sends  a  track  update  message  to  the  other  machine 
C_WSClient  client;  //create  the  object  RTRclient 
if  (cUentConnect(79,"128.49.133.12")  !=  WSC^SUCCESS) 
MessageBox(NULL,"Connection  Fail","  ",MB_OK); 

//endif 

//stmcpy(netbuf,  MQ[MQndx-l],90); 
clientSend(MQ[MQndx-l]);  //netbuf); 
cIienLSend("\r\n"); 
clientCloseConnectionO; 


}//endif 

}eise{  //first  two  messages  pass  through 

//the  following  sends  a  track  update  message  to  the  other  machine 
C_WSCIient  client;  //create  the  object  RTRclient 
if  (cUentConnect(79,"128.49.133.12")  !=  WSC^SUCCESS) 

MessageBox(NULL, "Connection  Fail","  ",MB_OK); 

//endif 

//stmcpy(netbuf,  MQ[MQndx-l],90); 
client  Send(MQ[MQndx-l]);  //netbuf); 
clicntSend("\r\n"); 
clientCloseConnectionO; 

}//endif 

return  1; 


TrkQ::TrkQO{ 

int  ndx; 

for(ndx=Omdx<MAXTRKSmdx++)  {  /initialize  die  track  array 
TQ[ndx]=NULL; 

}//endfor 

newTrk  =  new  Trie; 
nTrks  =  0; 
minlt=  19.0; 
maxlt“23.0; 

minlg  =  -162.0;  //this  is  for  op  area  field  of  view 
maxlg  = -158.0; 
dellt  =  maxlt  -  minlt; 
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dellg  =  maxlg  -  minlg; 

newTikTxt  =  0;  //default  for  null  number  of  TricTxt  windows 
xdTrkTxt  =0;  //Initialize  to  no  delta  for  TrkTxt  windows 
ydTricTxt  =0; 

}//end  TrkQ  constructor 

TricQ::~TrkQ0{ 

intndx; 

for(ndxN)mdx<MAXTRKS;ndx-H-){  //delete  the  track  array 
ifrrQ[ndx]!=NULL)  {delete  TQ[ndx];} 

}//endfor 
nTrks  =  0; 

}//end  TrkQ  destructor 

int  TrkQ:nipd(char  ♦pTstr){ 

if(  (*(pTstr  +  16))  =  ’2'){  //verify  valid  message  type 

stmcpy(newTrk->typStr,pTstr+ 15,  4);  //type  of  track 
stmcpy(newTrk->numStr,pTstr  +  40,  3);  //track  number 
int  tmpnum; 

tmpnum  =  atoi(newTrk->numStr); 
int  ndx  =  0; 

while(  (ndx  <  MAXTRKS  )  //search  for  existing  track 

&&(TQ[ndx]  !=NULL  )){ 
if(TQ[ndx]->num  =  tmpnum)  {break;}  //endif  this  track  exists 
ndx++;  //note  problem  with  testing  NULL  ptr 

}//endw^ile 

iflfrQ[ndx]=NULL){ 

TQ[ndx]  =  newTrk;  //we  are  adding  a  new  track 
TQ[ndx]->num  tmpnum; 

nTrks++;  //need  to  add  error  handling  for  case  of  MAXTRKS 
newTik  ~  new  Trie; 

}else{ 

strcpy(TQ[ndx]->01dMsg,TQ[ndx]->CurMsg); 

}//endif 

stmcpy(TQ[ndx]->timStr,pTstr  ,  12);  //timestamp  of  track  message 
//strcat(TQ[ndx]->timStr,”\0”);  //end-of-string 
stmcpy(TQ[ndx]->typStr,pTstr+  15,  4);  //type  of  track 
stmcpy(TQ[ndx]->strStr,pTstr  +  21,  8);  //undefined  characters 
stmcp)^Q[ndx]->numStr,pTstr  +  40,  3);  //track  number 
strcpy(  TQ[ndx]->romStr,pTstr  +  43);  //rest  of  message  string 

chartmpsfr[64]; 

ifl[strcmp(TQ[ndx]->typStr,"02:2")=0){ 
stmcpy(  tmpstr,  pTstr  +  50, 10); 

TQ[ndx]->altRaw  =  atof(tmpstr); 

}else  { 

TQ[ndx]->altRaw  =  0.0; 

}//endif 

float  tmpx  =  TQ[ndx]->xRaw; 
float  tmpy  =  TQ[ndx]->yRaw; 
stmcpy(  tmpstr,  pTstr  +  62, 7); 

TQ[ndx]->xRaw  =  atof(tmpstr); 

TQ[ndx]->xdRaw  =  TQ[ndx]->xRaw  -  tmpx; 
stmcpy(  tmpstr,  pTstr  +  70, 9); 

TQ[ndx}->yRaw  =  atof(tmpstr); 

TQ[ndx]->ydRaw  =  TQ[ndx]->yRaw  -  tmpy; 
stmcpy(  tmpstr,  pTstr  +  80, 9); 

TQ[ndx]->spRaw  =  atof(tmpstr); 
strcpy{TQ[ndx]->CurMsg,pTstr); 
ifrrQ[ndx]->M(Jndx<MXTKMS)  { 

TQ[ndx]->MQ[TQ[ndx]->M()ndx]  =  pTstr, 

TQ[ndxj->MQndx++; 

}//endif 

TQ[ndx]->dmsg0;  //send  the  message  via  delta  messaging 
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} 

else 

{ 

//the  following  sends  a  track  update  message  to  the  other  machine 
C_WSClient  client;  //create  the  object  RTRclient 
if  (clientConnect(79,"128,49.133.12")  !=  WSC^SUCCESS) 
MessageBox(NULL,"Connection  Fail",”  ",MB_OK); 

//endif 

clientSend(pTstr); 

clientSend("\r\n"); 

clientCloseConnectionO; 

}//endif 
return  0; 

}//end  TricQ  update 

int  TrkQ::rescaleO{ 

if(  nTrks>  1){ 

minlt=TQ[0]->xRaw; 
maxlt=TQ[0]->xRaw; 
minlg=TQ[0]->yRaw; 
maxlg=TQ[0]->yRaw; 
int  ndxOO; 

for(ndxOO=OmdxOO<nTrksmdxOO++)  { 
ii(minlt  >  TQ[ndxOO]->xRaw){minlt=TQ[ndxOO]->xRaw;}//endif 
if(maxlt  <  TQ[ndxOO]->xRaw){maxlt==TQ[ndxOO]->xRaw;}//endif 
if(minlg  >  TQ[ndxOO]->yRaw){minlg=TQ[ndxOO]->yRaw;}//endif 
if(maxlg  <  TQ[ndxOO]->yRaw){maxlg==TQ[ndxOO]->yRaw;}//endif 
}//endfor 

dellt  =  maxlt  -  minlt; 
dellg  =  maxlg  -  minlg; 

#define  SCFAC0.5 
if(dellt>0.0){ 
minlt -=(SCFAC*  dellt); 
maxlt  +=  (SCFAC  ♦  deUt); 

}  else  { 

minlt  -=  (SCFAC  *  minlt); 
maxlt  +=  (SCFAC  ♦  maxlt); 

}//endif 
if(dellg>0.0){ 
minlg  -=  (SCFAC  *  dellg); 
maxlg  +=  (SCFAC  ♦  dellg); 

}  else  { 

minlg  -=  (SCFAC  ♦  minlg); 
maxlg  +=  (SCFAC  *  maxlg); 

}//endif 

dellt  =  maxlt  -  minlt; 
dellg  =  maxlg  *  minlg; 

>//endif 


return  0; 

}//cnd  rescaleO 


TrkQ  •pTQ; //pointer  to  the  track  queue 


//  zpb_end 

//  ToolBar  Member  Functions  -  MainTools 

tbMamMainToob::d>MainMainTools(zMDIMarginFrame  *w,  zSizer  *sz,  zBitm^  *bmp) 
:  zToolbar(w,  sz)  { 
tfaeBmp  =  bmp; 

(ZNEW  zToolButton(diis,  ZNEW  zSizei(zPoint(l  1,2),  zDimension(24,22)), 
0,  IDM_HELPCONTENTS,  AeBmp,  zRect(l  12, 0, 128, 15))) 

->show0; 

(ZNEW  zToolButton(dii5,  ZNEW  zSizeT(zPoint(48,2),  zDimension(24,22)), 
0,  IDM__RTRDXTEXT,  theBmp,  zRect(0, 0, 16, 15))) 
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->showO; 

//  zpb_bcgin  tbMainMainToolsConstnictor 
//zpb__end 


d)MainMamTools::~tbMainMainToolsO  { 

//  zpb^begin  ti^MainMainToolsEyestructor 
//  2pb_end 
if  (theBmp) 
delete  theBmp; 

} 

// 

//  Frame  Member  Functions  -  Main 

// 

//  Window  Constructor 
WMam::WMam(const  char  *title) 

:  2MDIAppFrame(0,ZNEW  zSiz^^TDFRAME, 

title,  ZNEW  zMenu(zResId(IDM_MDIWmdowMenu)))  { 
int  MDIWindowPos  =  1; 

//  2pb_begin  WMainConstructor2 
//zpb_end 

menu(ZNEW  zMenu(this,  zResId(IDM_MainMnMenu))); 
if  (MDIWindowPos  >=  0) 

menuO>insertDropDown(MDImenuO,  25tring(2ResId(IDS_MDIWINDOWMENlJ)),  MDIWmdowPos); 
else 

menu()->appendDropDown(MDImenuO,  zString(2ResId(IDS_MDIWINDOWMENU))); 

menuO->setCommand(this,  (ConimandProc)&WMain::cmdMDI>\rmdow,  IDM_CASCADE,  IDM_ARRANGEICONS); 
menu(>->setCommand(this,  (CommandProc)&WMain::cmdRTRDxDel,  IDM_RTRDXDEL); 
menuO>setCommand(this,  (CommandProc)&WMain::cmdRTRDxText,  IDM__RTRDXTEXT); 
menu()->setCommand(this,  (CommandProc)&WMain::cmdRTRDxSym,  IDM_RTRDXSYM); 
menuO>setCominand(this,  (CommandProc)&WMain::cmdRTRDxTrck,  IDM_RTRDXTRCK); 
menuO>setCommand(this,  (CommandProc)&WMain::cmdHeIpContents,  IDM_HELPCONTENTS); 
menuO>setCommand(this,  (CommandProc)&WMain::cmdHelpAbout,  IDM_HELPABOUT); 

//  Create  Tool  Bar  Mar^n  Frame 

zMDIMarginFrame  *ToolFrame  =  ZNEW  zMDIMarginFrame(this, 

ZNEW  zGrowToFitSi2er(ZGRAy_TOP,  sizerQ)); 

TooIFrame->showO; 

pTB  =  ZNEW  tbMainMamTools(TooIFrame,  ZNEW  zGravSizer(ZGRAV_TOP,  30,  ToolFrame->sizeiO),  ZNEW 

2flitm^zResId(IDB_MainMainTools))); 

pTB->showO; 

2MDIMarginFrame  *sf=ZNEW  2MDIMarginFrame(this,ZNEW  2GrowToFitSizer(ZGRAV_BOTTOM,sizerO)); 

zStatusLineEZ*  pSB  =  ZNEW  2StatusLineEZ(sf,  ZNEW  zGravSizer(ZGRAV_BOTTOM,0,  sf->sizerO),  ZSL  STANDARDITEM)* 

sf->showO; 

pSB->showO; 

ZNEW  ^tidssld((zMDIAppFiame^)zAppGetAppVar(app)->rootWindowO,  zString(zResId(IDS_JTIDSSLD))); 

//  zpb^begin  WMainConstructorl 
//q)b_end 

//  2pb_begin  WMainConstructor 

pSQ=  new  SlpQ;  //creates  the  sleep  queue  for  periodic  execution  of 

//member  functions. 


pTQ  —  new  TrkQ;  //creates  die  track  queue  for  this  window 


int  X  =  0; 

DWORD  dwResult  =  0; 

DWORD  dwThreadId; 

HANDLE  hThread; 

hlhread  =  CreateThread(NULL,  0,  ThreadFunc,  (LPVOID)  &x, 

0,  &dwThreadId); 

SetThrieadPriority(hThread,THREAD_PRIORITY_ABOVE_NORMAL); 

//  2q)b_end 

show(SW__MAXIMIZE); 
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} 

WMain::-WMamO  { 

//  zpb_begm  WMmnDestructorl 
//  zpb_end 

} 

// 

//  Menu  Item  Selection  Handlers 

// 

int  WMain::cmdMDIWindow(zCommandEvt*  ev)  { 

//  zpb^begin  WMainMDICmds 
switch  (ev->cmdO)  { 
case  IDM_C  ASCADE: 
cascadeQ; 
break; 

case  IDM_TILE: 
tileO; 

break; 

case  IDM^ARRANGEICONS: 
arrangelconsQ; 
break; 

} 

//  zpb_end 
return  0; 

} 

int  WMain::cmdRTRDxE)el(2CommandEvt*  ev)  { 

ZNEW  WDelWin((zMDIAppFrame*)zAppGetAppVar(app)->root)\^dowO,  2String(2ResId(IDS_DELWIN))); 
//  zpb_begin  WMainRTRDxDel 
//  ^b_end 
return  0; 

} 

int  WM^::cmdRTRDxText(zCommandEvt*  ev)  { 

ZNEW  WDxWm((zMDIAppFrame*)zAppGetAppVar(^p)->rootWindowO,  2String(zResId(IDS_DXWIN))); 

//  ^b_begin  WMainRTREbcText 
//  zpb_end 
return  0; 

} 

int  WMain::cmdRTRDxSym(zCominand£vt*  ev)  { 

ZNEW  WSymWin((zMDIAppFrame*)2AppGetAppVai(app)->rootWindowO,  2String(2ResId(TDS_SYMWIN))); 
//:q)b_begin  WMainRTRDxSym 
//  2pb_end 
return  0; 

> 

int  WMain::cmdRTRDxTrck(zCofnmazKlEvt*  ev)  { 

ZNEW  WTrkWui((zMDIAppFrame*)2:^>pGctAppVar(2q>p)->rootWindowO,  2String(zResId(IDS_TRKWIN))); 
//  2pb_begin  WMainRTRDxTrck 
//  2pb_end 
return  0; 

} 

int  WMain::cmdHelpContents(2Cominand£vt*  ev)  { 

//zpb__begin  WMaincmdHelpContents 
//  zpb_end 
return  0; 

} 

int  WMain::cmdHelpAbout(2CommandEvt*  ev)  { 

DAbout*  p^ZNEW  DAbout(diis,  zR«Id(IDD_About)); 

p->modal0; 

if  (p“>completedO)  { 

//  zpb_begin  WMainHelpAbout 
//  ^b_end 
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}  else  { 

//  zpb_begm  WMainHelpAboutCancel 
//  zpb_end 
} 

delete  p; 
return  0; 

} 

//  zpb_begin  WMainMemberFunctions 
//  zpb_end 


//  Pane  Member  Functions  -  DxWmDxTxtPane 

DxWinDxTxtPane::Dx>\%iDxTxtPane(zWindow  *w,  zSizer  *sz) :  zPane(w,  sz,  WS_CHILD)  { 

//  2pb_begin  pDxWinDxTxtPaneConstnictorl 

//  zpb_end 

showQ; 

} 

int  DxWinDxTxtPane::size(zSizeEvt  *ev)  { 
setDirtyO; 

//  zpbbegin  DxWinDxTxtPaneSize 
//  zpb_end 

return  zWmdow::size(ev); 

} 

int  DxWinDxTxtPane::draw(zDrawEvt*  ev)  { 
canvasO->lockO; 

//  zpbbegin  E>xTxtPaneDraw 
//local  constants 

#define  N_DXMSGS  18  //  total  number  of  messages  displayed  on  die  pane 

#define  x_head  3  //  x  coordinate  for  the  header  row 

#define  y__head  10  // y  coordinate  for  the  header  row 

#define  x_mbase  3  //  x  coordinate  for  base  (first  row)  of  display  messages 

#define  y_mbasel0  //  y  coordinate  for  base  (first  row)  of  display  messages 

#define  m_strt  0  //  starting  message  number 

#define  r^offset  15  //offset  for  spacing  between  rows 

//local  variables 
int  tmp_ndx; 
int  IbufNdx; 
int  r_ndx; 
int  r__curr; 

char  ♦msg_cuiT[N_DXMSGS]; 

//set  up  tile  display  parameters 

canvasO->pushFont(new  2Font(’’Helv",zPrPoint(  1 2^5,canvas0),9004ff)ontCare)); 

//clear  tiie  window  pane 
zRect  DxTxtArea; 
canvas()“>getVisibIe(DxTxtArea); 

//canvasO>pushPen(new  zPen(zColoi(GREEN),  Solid,  5)); 
canvasO->ptishBrush(new  zBrush(zColor(255,128,128))); 
canvasO->rectangle(DxTxtArea); 

//delete  canvasO->popPenO; 
delete  canvasO->popBnish(); 

//set  up  the  display  parameters 
//  “  select  a  newly  created  font 
canvas()->backColor(GRAY); 
canvasO->setTextBackMode(ZTEXT_TRANSPAREND; 

r_ndx=  DxBufNdx; 

for(tmp_ndx=0;tmp_ndx<N_DXMSGS;tmp_ndx-H')  //loop  through  the  number  of 


//temporary  index 

//row  index  for  looping  through  the  active  messages  currently  displayed 
//actual  index  into  the  buffer  of  messages 


124 


{  //lines  displayed  in  the  window 

r_curr  =  r__ndx-tmp_ndx;  //from  most  current  to  past 

if(  (r_cuiT  <=  DxBufInp) 

&&(r_curr  )){ 

msg_cuiT[tmp_ndx]  =  DxBuf[r__curr]; 

}else{ 

msg_curr[tmp_ndx]  =  NULL; 

}//endif 

}//endfor 

for(tmp_ndx=0;tmp_ndx<N_DXMSGS,’tmp_ndx-H')  //loop  through  the  number  of 
{  //lines  displayed  in  the  window 

//  the  following  ou^uts  a  message  to  die  DXFile  window 
id;msg_curr[tmp__ndx]  !=NULL) 

{ 

canvasO->text(x_mbase, 

(y_mbase+(tmp_ndx*r_offeet)), 

msg^curr[tmp_ndx]); 

}//endif 

}//endfor 

delete  canvasO>popFont(); 

//zpb_end 
canvasO->un]ockO; 
return  1; 


// 

//  Frame  Member  Functions  >  Dx>^ln 

If 

//  Window  Constructor 

WDxW^::WDxWin(zMDIAppFrame  ♦w,  const  char  ♦title) 

:  zMDIChildFrame(WyZNEW  zSizeT(zDialogUmt(0,0), 

zDialogUnit(310,130)),WS_CHILD|WS_THICKFRAME|WS_SYSMENU|WS_.MINIMIZEBOX|WS_CAPnON,  title)  { 

//  zpb Jsegin  WDxWinConstructor2 

drwRt=1000L; 

drwTm=0L; 

msgRt=255L; 

msgTm=0L; 

#define  DXSR  8L  //  this  object  wakes  up  at  the  fastest  message  freq. 

//  zpb__end 

deleteOnClosefTRUE); 

backgroundColor(zColor(255,l 28,1 28)); 

menu(ZNEW  zMenu(this,  zResId(IDM_DxWinDxMenu))); 

menuO->setCommand(this,  (CommandProc)&WDxWm::cmdControIRefresh,  IDM_CONTROLREFRESH); 
menu(>>setCommand(this,  (CommandProc)&WDxWin:;cmdControlMsgRate,  IDM_CONTROLMSGRATE); 
pDxTxtPane  =  ZNEW  DxWinDxTxtPane(this,  ZNEW  zGravSi2er(ZGRAV_MIDDLE,0,si2erO)); 
pDxTxtPane->showO; 
si2er0->update0; 

//  zpb_begin  WDxWinConstnictorlOpenDlg 
char  ♦types[6); 

types[0]  =  "All  FUes  (♦.♦)",  typcs[l]  =  "♦.♦"; 
types[2]  =  "Text  Files  (♦.txt)",  types[3]  =  "♦.txt"; 
types[4]  =  typest5J-0: 

zFUeOpenFonn  •p  =  ZNEW  zFiieOpcnForm(this,"Open  File",  0,  types); 
if(p->completed0)  { 

//  Use  p->name0  to  retrieve  filename 
char  ♦fiiame; 
char  ♦line; 
frtreamfin; 
fiiame  =  p»>name0; 
fin.open(fiiame,ios::in); 

DxBufInp=0; 

line  =  new  char(LBUFSZ+l  ]; 
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fin.getline(lmeXBUFSZ); 
while(  (  (line[2]  !-*:’) 

||(line[5]  !=':•) 

||(line[8]  !=V)) 
&&(DxBufInp  <20  )){ 

fm.getIine(IineXBUFSZ); 

DxBufInp++; 

}//endwhiIe 

DxBufInp=0; 

DxBufpicBufInp]  =  line; 

DxBufInp-H-; 

line  =  new  char[LBUFSZ+l]; 
char  tbufI64]; 

while(  (fin.getline(Iine4^BUFSZ)  ) 

&&(DxBufInp  <  DXBUFSZ  )){ 
//stmcpy(tbuf,Iine  +  15,  4);  //type  of  track 
irmt  tbufiidx; 

//for(tbufiidx=0;tbufiidx<4;tbufiidx-H-)  { 

//  tbuf[tbiij&idx]  =  (♦(line+l  5)); 

//}//endfor 

if((*(line+ 1 6))  =  7')  {  //verify  valid  message  type 

DxBuf[E)xBufInp]  =  line; 
DxBufInfH-+; 

line  =  new  char[LBUFSZ+l  ]; 

}//endif 

}//endwhiIe 

fin.closeO; 

DxBufNdx=0;  //Set  buffer  index  to  beginning  of  buffer 

} 

delete  p; 

//zpb_end 

//  q)b_begin  WDxWinConstructorl 


//  tiiis  block  of  code  finds  a  previous  message  that  is  "closest"  to 
//  the  current  message.  The  index  of  diis  message  is  saved.  Note  that 
//  die  previous  message  has  an  index  to  a  previous  message  that  it 
//  was  closest  to.  Those  two  messages  will  be  used  to  generate  a 
//  "delta  message"  format  This  block  of  code  links  the  messages 
//  before  the  demo  starts.  After  the  algorithm  is  tested  and  verified 
//  die  code  will  be  moved  to  the  location  wdiere  it  will  run  in  realtime. 
//  inttmpndx; 


//  #define  CCMAX  20  //  compare  last  CCMAX  messages  from  current 

//  for(tmpndx=CCMAX;tmpndx<DxBufInp;tmpndx'H-){//start  comparing  after  CCMAX 
//  char  ♦Inptr  =  DxBufftmpndx];  //current  line  pointer 
//  int  Insz  ~  strlen(lnptr);  //size  of  current  line 
//  int  ccndx;  //index  into  the  messages 

//  for(ccndx=CCMAX;ccndx>0;ccndx— ){  //last  CCMAX  messages  to  be  compared 


// 

// 

// 

// 

// 

// 

// 

// 

If 

II  int  slndx; 
// 

// 

// 

// 

// 

// 

// 

//  }//endfor 
//  }//endfor 


char  *strptr  =  DxBufftmpndx-CCMAX];  //previous  message 
int  strsz  =  strlen(strptr);  //size  of  previous  message 

int  strmin; 
if(lnsz<strsz){ 
strmm=lnsz; 

}  else  { 
sirmin=strsz; 

}//endif 

int  strdel  ~  abs(lnsz  > 


//min  message  length 
//current  line  is  shortest 
//previous  line  is  shortest 
strsz);  //diff  is  counted  as  diff  chars 


for(slndx=0;slndx<stnnin;slndx++){  //compare  char  for  char 
if(  (*strptr)  1=  (♦Inptr) ){  //if  diff  then  inc  delta 
strdel-H-; 

}//endif 

strptr-H-;  //inc  char  location  in  each  str 

lnptiH-+; 

}//endfor 
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//  zpb_end 

//  zpb_begin  WDxWinConstructor 

//Create  the  track  display  for  this  message  stream 

ZNEW  WTrkWin((zMDIAppFrame*)zAppGetAppVar(app)->rootWmdow(),  zString(zResId(IDS_TRKWIN))); 
pSQ->Slp(this,  DXSR);  //wake  window  every  x  ticks 

//  zpb_end 
showO; 

} 

WDxWinri-WDxWinO  { 

//  zpb_begin  WDxWinDestmctorl 

pSQ->Rm(this);  //Remove  this  window  from  the  sleep  queue 

//  qjb^end 

} 

// 

//  Menu  Item  Selection  Handlers 

// 

int  WDxWin::cmdControlRefresh(zCommandEvt*  ev)  { 

DMsgRfsh*  p=ZNEW  DMsgRfsh(this,  2ResId(IDD_MsgRfsh)); 

p->modalO; 

if  (p->completedO)  { 

//  zpb__begin  WDxWinControlRefresh 
drwRt  “  (unsigned  long)  atol(p->_DRt); 

//  zpb_end 
}  else  { 

//  2pb_begin  WDxWmControlRefreshCancel 
//  zpb_end 
} 

delete  p; 
return  0; 

} 

int  WDxlMn::cmdControlMsgRate(zCommandEvt*  ev)  { 

DMsgRate*  p=ZNEW  DMsgRate(this,  2ResId(IDD_MsgRate)); 

p->modalO; 

if(p->completedO)  { 

//  ^b_begin  WDxWinControlMsgRate 
msgRt  =  (unsigned  long)  atol(p->_Mrt); 

//  qjb^cnd 
}  clsc{ 

//  zpb_begin  WDx>\^mControlMsgRateCancel 
//  2pb_end 

delete  p; 
return  0; 


//  zpb_begin  WDxWinMemberfunctions 

tnt  WDxWinrrwakcO  { 

zDraw^vt  •tmpEv; 
if(pSO-^>systime  >=  drwTm){ 
if(pTQ!=NULL){ 
iI(pT(^>TQ!=NULL){ 
intupdndx; 

for(updndx=03ipdndx<pTQ->nTrks;updndx-H-){  //Refresh  txt  window 

ifl;pTQ->TQ[updndx]->TxWn  !=  NIJLL){ 
pTQ->TQ[updndx]->TxWn->rtrdrwO; 
)//endif 

if(pT()->TQ[updndx]->AnWn  !=  NULL){ 
pTQ->TQ[updndx]->AnWn->rtrdrw(); 
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}//endif 


}//endfor 

}//endif 

}//endif 

pDxTxtPane->dra\v(tinpEv); 
drwTm  =  pSQ->systime  +  drwRt; 

}//endif 

if(pSQ->systime  >=  msgTm){ 

DxBufNdx-H-; 

if(DxBufNdx>=E)xBufInp){  //not  end  of  buffer,  i.e.  index  less  than  inputs 
DxBufNdx  =  0;  //loop  back  to  beginning  of  message  buffer 

}//endif 

pTQ->upd((char  *)DxBuf[DxBufNdx]);  //update  the  track  display  queue 

//with  the  new  message 

msgTm  =  pSQ->systime  +  msgRt; 

}//endif 
return  0; 

} 

// 

//  Sleep  Queue  Member  Functions 

// 

//  constructor 
SlpQ::SIpQO{ 

systime  =  GetCuirentTimeO; 
int  ndx; 

for(ndx=0;ndx<NTASKSmdx++)  { 
sq[ndx]  =-NULL; 

SITm[ndx]=0; 

}//endfor  ndx 
}//cnd  SlpQO 
// 

//  destructor 
SipO:-SlpQO{ 

}//ciid -SlpQO 

// 

//  Periodic  Execution  Every  Specified  Number  of  Ticks 
int  S4>Q:iSlp(zMDIChildFramc  •wptr,  unsigned  long  tcks){ 
int  ndx; 

for(ndx==<)mdx<NTASKS^idx++)  { 
if(  (sq[ndx]  =  NULL  )){ 

sq[ndx]  =wptr; 

SlTm[ndx]=tcks; 

WkTm[ndx]— systime+tcks; 
return  0; 

}//endif 
}//endfor  ndx 
return  0; 

}//cndSlpO 

// 

//  Check  die  Sleep  Queue  for  Any  Member  Functions 

int  SlpQ:K:kQ0  { 

systime  =  GctCurrentTimeO; 
int  sndx; 

for(sndx=<hsndx<NTASKS;sndx++){ 
if(  (sq[sndx]  !=NULL  ) 

&&(WkTm[sndx]  <=  sysdme)){ 

WkTm[sndx)=systime^'SlTm[sndx]; 

sq[sndx]->wakeO; 

return  0; 

}//cndif 
}//endfor  ndx 
return  0; 

}//endCkQ() 

// 

//  Remove  window  fium  the  queue 
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int  SlpQ::Rm(zMDIQiiIdFrame  ♦wptrX 
intndx; 

foKncix==<)yidx<NTASKS;ndx-H')  { 
if(  (sq[ndx]  =wptr)){ 

sq[ndx]  =NULL; 
SlTin[ndx]=0; 
WkTm[ndx]=0; 
return  0; 

}//endif 
}//endfor  ndx 
return  0; 

}//end  RmO 
// 

//  End  Sleep  Queue  Member  Functions 

// 

// 

//  The  Following  is  a  Single  Thread  Used  for  Application  Multitasking 

// 

DWORD  WINAPI  ThreadFimc(LPVOID  lpvThreadPann){ 

DWORD  dwResult  =  0; 

#define  SlpQRt  IL  Z/tiiis  is  the  fastest  rate  any  method  can  run 
int  done  =  0; 
while(done  =  0){ 
done  -  pSQ->QcQ0; 

Sleep{SlpQRt); 

}//endforever 

retum(dwResult); 

}//end_ThreadFuncO 


//  zpb_end 


//  Pane  Member  Functions  -  TrkWinTrkPane 

TrkWinTrkPane::TrkWmTricPane(zWindow  ♦w,  zSizer  ♦sz) :  zPane(w,  sz,  WS_CHILD|WS_BORDER)  { 
//  zpb_begin  pTrk^^TrkPaneConstructorl 

//this  is  ^ere  we  determine  ^^ch  track  to  display 
bmpha  =  new  zBitmap(canvasO*  "sym/diamup.bmp"  ); 
bmphs  =  new  zBitmap(canvasO,  ”sym/diamdwn.bmp"  ); 
bmphsf  =newzBitm^canvasO,  ”sym/diam.bmp”  ); 
bmpukna  -  new  zBitm^canvasQ,  "sym/sqrup.bmp”  ); 
bmpukns  =  new  zBitmap(canvasO,  "sym/sqrdwn.bmp"  ); 
bmpuknsf  =  new  zBitmap(canvasO>  "sym/sqr.bmp"  ); 

bmpfe  =  new  zBitxns^canvasO*  "sym/circleup.bmp" ); 
bmpfs  =  new  zBitma^canvasQ*  "sym/circledwiLbmp**); 
bmpfef  =  new  zBitm^canvasO,  "sym/circle.bmp"  ); 

//  ^b_end 
showQ; 


int  TrkWinTrkPane:nnouseButtonDown(zMouseClickEvt*  ev)  { 

if  (ev->isButton(l))  {  //  Left  Button  Pressed 

//  zpb_be^  TrieWinTrkPaneLButtonDown 
int  DTndx  =  0; 
zPoint  mpos; 

mpos  -  ev->posO;  //^ves  us  tiie  position  when  clicked 

int  mousex  =  mpos  jcQ; 

int  mousey  =  mpos-yO; 

int  closex  =  pT^>TQ[DTndx]->xpos; 

int  closey  =  pTQ->TQ[DTndx}->ypos; 

pTQ->DTmdx  =  DTndx; 

for(DTndx=  1  ^)Tndx<pTQ->nTrks;DTndx++)  { 
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if(  (  abs(pTQ->TQ[DTndx]->xpos  -  mousex) 

<  abs(  closex  -  mousex)) 

&&(  abs(pTQ->TQ[DTn<ix]->ypos  -  mousey) 

<  abs(  closey  -  mousey)))  { 

closex  =  pTQ->TQ[DTndx]->xpos; 
closey  =  pTQ->TQ[DTndx]->ypos; 
pTQ->D'nndx  =  DTndx;  //update  the  DTInfo()  ndx 
}//endif 
}//endfor 

DTInfo*  p=ZNEW  DTInfo(this,  zResId(IDD_TInfo)); 

p->modalO; 

if  (p->completedO)  { 

//  hook  for  later  code 

pTQ->TQ[pTQ->Drmdx]->distype  =  p->UpdAtt(pTQ->TQ[pTQ->DTmdx]->dTypStr); 
}//endif 
delete  p; 

//  25)b_end 

} 

else 

if  (ev->isButton(2))  { //  Right  Button  Pressed 
//  zpb_begin  TrkWinTrkPaneRButtonDown 
int  NTndx  =  0; 
zPoint  mpos; 

mpos  =  ev->posO;  //gives  us  the  position  when  clicked 

int  mousex  =  mpos-xQ; 

int  mousey  -  mpos.yQ; 

int  closex  =  pTQ->TQ[0]“>xpos; 

int  closey  =  pTQ->TQtO]->ypos; 

pTQ->newTricTxt  =  0; 

for(NTndx=l  ;NTndx<pTQ->nTrics^^rrndx’H-){ 
ifi;  (  abs(pTQ->TQ[NTndx]->xpos  -  mousex) 

<  abs(  closex  -  mousex)) 

&&(  abs(pTQ->TQ[NTndx]->ypos  -  mousey) 

<  abs(  closey  -  mousey)))  { 

closex  =  pTQ->TQ[NTndx]->xpos; 
closey  =  pTQ->TQ[NTndx]*>ypos; 
pTQ->newTrkTxt  =  NTndjq  //update  the  TrkTxtQ  ndx 
}//endif 
}//endfor 

const  char  trkmsg[256]  =  Track  Analysis”; 

//strcat(tikmsg,  pTQ->TQ[NTndx]->numStr); 
if(pTQ^TQ[pTQ->newTrkTxt]  !=  NULL){  //Track  must  exist 
if(pTO->TQ[pTQ->newTricTxt]->TxWn  =  NULL)  {  //Only  one  window  per  track 
ZNEW  WTrkTxt((zMDIAppFrame*)zAppGetAppVar(^p)->rootWindowO,  trkmsg); 

}//endif 

}//cndif 

//zpb  end 

} 

return  0; 


int  TrkWinTrkPane::si2e(2SizeEvt  •ev)  { 
setDirtyO; 

//  qf)b_bcgin  TrkWinTrkPaneSize 
//  zpb_cnd 

return  zWindow::si2e(ev); 


int  TrkV^TrkPane::draw(zDrawEvt*  ev)  { 
canvasO->lockO; 

//  2pb_begin  TrkPaneDraw 
//local  constants 
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//local  variables 


//clear  the  window  pane 
zRect  DxTxtArea; 
canvasO->getVisible(DxTxtAiea); 
canvasO->pushPen(new  zPen(zCoior(GREEN),  Solid,  5)); 

//  canvasO>pushBrush(new  zBnish(DarkGiayBnish)); 

canvasO->pushBnish(new  zBrush(zColor(0,0,0))); 
canvasO->rectangle(DxTxtArea); 
delete  canvasO>popPenO; 
delete  canvasO->popBrushO; 

//set  up  the  display  parameters 

// — select  a  newly  created  font 

//canvasO">backColor(zColor(0,0,0)); 

canvasO->setTextBackMode(ZTEXT_TRANSPARENT); 

canvasO>pushFont(new  zFont("Helv",zPrPoint(  1 2,25,canvasO),900,ffDontCare)); 

//draw  a  line  >  will  use  die  pen 
intndx; 

for(ndx=0;ndx<pTQ->nTrks3dx-H-){ 
canvasO->textColor(pTQ->TQ[ndx]->clr); 
canvasO->pushPen(new  zPen(pTQ->TQ[ndx]*>clr,Solid,  1 )); 
float  xtmp,ytmp; 
intx,y; 

#defoe  WINDLT  3 

xtmp=  ((float)I>xT3ctArea.widthO) 

*  ((pTQ->TQ[ndx]->xRaw  -  pTQ->minlt)/pTQ->dellt); 

X  =  DxTxtArea.lefiO  +  (mt)xtmp; 
if(x<={DxTxtArea.leftO  +  WINDLT))  { 
x=DxTxtArea.leftO  +  WINDLT; 

}//endif  check  lower  bound 
id[x>=(DxTxtAreajightO- WINDLT))  { 
x=DxTxtAreajightO  -  WINDLT; 

}//check  upper  bound 

ytmp=  ((float)DxTxtAreaJheightO) 

*  ((pTQ->TQ[ndx]->yRaw  -  pTQ->minlg)/pTQ->dellg); 
y  =  DxTxtArea.topO  +  (mt)ytmp;  //new  y  for  display 

if(y<=<DxTxtArea.topO  +  WINDLT))  { 
y=DxTxtArea.topO  +  WINDLT;  /^lip  to  top  of  window 
}//endif  check  lower  bound 
if(y>=<DxTxtArea.bottom(>  WINDLT))  { 
y=DxTxtArea.bottomO  -  WINDLT;  //clip  to  bottom  of  window 
}//check  upper  bound 
switch(pT(^>TQ[ndx]->distype)  { 

case  HOSTILE_AIR: 

canvasO>bitmap(bmpha,zPoint(x-10,y-20),  SRCCOPY); 
canvasO->textColor(zColor(255,0,0)); 
canvasO->text(x-l  1,  y,pTQ->TQ[ndx]->numStr); 
if(  (pTQ->TQ[ndx]->xpos  !=  0) 

||(pTQ->TQ[ndx].>ypos  !=  0)){ 
canvasO>moveTo(x,y); 

canvasO>lineTo(pTQ->TQ[ndx]->xpos,pTQ>>TQ[ndx]->ypos); 

}//endif 

pTQ^TQ[ndx]->xpos  =  x; 
pTQ->TQ[ndx]->ypos  =  y; 
break; 

caseHOSTILE__SUB: 

canvasO>bitmap(bmphs,2Point(x-10,y),  SRCCOPY); 
canvasO>textColoi(zColoi(255,0,0)); 
canvasO‘>text(x-l  1,  y+20,pTQ->TQ[ndx]->numSlr); 
if(  (pTQ->TQ[ndx]->xpos  !=  0) 

||(pTQ->TQ[ndx]->ypos  !=  0)){ 
canvasO->moveTo(x,y); 

canvasO->lineTo(pTQ->TQ[ndx]->xpos,pTQ->TQ[ndx]->ypos); 
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}//endif 

pTQ->TQ[ndx]->xpos  x; 
pT(^>TQ[ndxj->ypos  -  y; 
break; 

case  HOSTILE^SURFACE: 

canvas()->bitmap(bmphsf^oint(x- 1 2,y- 1 2),  SRCCOPY); 
canvas()->textColor(zColor(255,0,0)); 
canvas()->text(x-12,  y+1  l,pTQ->TQ[ndx]->numStr); 
if(  (pTQ->TQ[ndx]->xpos  !=  0) 

||(pTQ->TQ[ndx]->ypos  !=  0)){ 
canvas()->moveTo(x,y); 

canvas(>>ImeTo(pTQ->TQ[ndx]->xpos,pTQ->TQ[ndx]->ypos); 

}//endif 

pTQ->TQ[ndx]->xpos  =  x; 
pTQ->TQ[ndx]->ypos  =  y; 
break; 

caseUNKNOWN^AIR: 

canvasO->bitmap(bmpiikna;zPoint(x- 1 0,y-20),  SRCCOPY); 
canvas0->textCoIor(zColor(255^55^55)); 
canvas()->text(x-12,  y,pTQ->TQ[ndx]->nuinStr); 
if(  (pTQ->TQ[ndx]->xpos  !=  0) 

||(pTQ->TQ[ndx]->ypos  !=  0)){ 
canvasO->inoveTo(x,y);  * 

canvas(>>IuieTo(pT(^>TQ[ndx]->xpos,pTQ->TQ[ndx]->ypos); 

}//endif 

pTQ->TQ[ndx]->xpos  =  x; 
pTQ->TQ[ndx]*>ypos  =  y; 
break; 

caseUNKNOWN^SUB: 

canvasO->bitmap(bmpukns^oint(x- 1 0,y),  SRCCOPY); 
canvasO->textCoIor(zColor(255^55^55)); 
canvasO>text(x-12,  y+20,pTQ->TQ[ndx]->numStr); 
(pTQ->TQ[ndx]->xpos  !=  0) 

||(pTQ.>TQ[ndx]->ypos  !=  0)){ 
canvasO->nioveTo(x,y); 

canvasO->lineTo(pTQ->TQ[ndx]->xpos,pTQ->TQ[ndx]->ypos); 

}//endif 

pTQ->TQ[ndx]->xpos  =  x; 
pTQ->TQ[ndx]>>ypos  =  y; 
break; 

case  UNKNOWN^SURFACE: 

canvas0->bitmap(bmpiikns^omt(x-10,y-10),  SRCCOPY); 
canvasO->textCoIor(2Color(255;255^55)); 
canvasO->text(x-l  1,  y+10.pTQ->TQ[ndx]->niimStr); 
if(  (pTQ->TQ[ndx]->xpos  !=  0) 

||{pTQ->TQ[ndx]->ypos  !=  0)){ 
canvasO->moveTo(x,y); 

canvasO->lineTo(pTQ->TQ[ndx]'>xpos,pTQ->TQ[ndx]->ypos); 

}//endif 

pTQ->TQ[ndx]*>xpos  =  x; 
pTQ->TQ[ndx]->ypos  =  y; 
break; 

case  FRIENDLY^AIR: 

canvasO->bitm^)(bmpfe;zPoint(x-8,y- 1 7),  SRCCOPY); 
canvas0->textColor(2Color<0^55455)); 
canvas0->text(x-9,  y+l,pT(^>TQ[ndx]->numStr); 
if(  (pTQ->TQ[ndx]->)qx>s  I-  0) 

|j(pTQ->TQ[ndx]->ypos  !=  0)){ 
canvasO->moveTo(x,y); 

canvasO->lineTo(pTQ->TQ[ndx]‘>xpos,pTQ->TQ[ndx]->ypos); 

}//endif 

pTQ->TQ[ndx]->xpos  =  x; 
pT<^>TQ[ndx]->ypos  =  y; 
break; 

case  FRIENDLY_SUB: 

canvas0->bitmap(bmpfs^omt(x-8,y),  SRCCOPY); 
canvas()->textColor(zColor(0^55^55)); 
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canvas()->text(x-9,  y+1 8,pTQ->TQ[ndx]->numStr); 
if(  (pTQ->TQ[ndx]->xpos  !=  0) 

l|(pTQ->TQ[ndx].>ypos  !=0)){ 
canvasO->moveTo(x,y); 

canvas()->IineTo(pTQ->TQ[ndx]->xpos,pTQ->TQ[ndx]->ypos); 

}//en<lif 

pTQ->TQ[ndx]->xpos  =  x; 
pTQ->TQ[ndx]->ypos  =  y; 
break; 

case  FRIENDL  Y_SURFACE: 

canvas()“>bitmap(bmpfsf^omt(x-l  l,y-l  1),  SRCCOPY); 
canvas(>>textColor(^lor(0^55^55)); 
canvasO>text(x-l  1,  y+12,pTQ->TQ[ndx]->numStr); 
(pTQ->TQ[ndx]->:q)Os!=0) 

||(pTQ->TQ[ndx]->ypos  N  0)){ 
canvasO->moveTo(x,y); 

canvasO>lmeTo(pTQ->TQ[ndx]->xpos,pTQ->TQ[ndx]->ypos); 

}//endif 

pTQ->TQ[ndx]->xpos  =  x; 
pTQ->TQ[ndx]->ypos  =  y; 
break; 

};  //end  case  statement 
//pTQ->TQ[ndx]->distypeH-; 

//if  (pTQ->TQ[ndx]->distype  >  8)pTQ->TQ[ndx]->distype  =  0; 

//canvasO->text(x,  y,pTQ->TQ[ndx]->numStr); 

delete  canvasO->popPenO; 

}//endfor  ndx 

//canvasO->textColor(BLACK); 
delete  canvasO->popFontO; 

//  ^b_end 
canvasO>unlockO; 
return  1; 

} 


// 

//  Frame  Member  Functions  -  TricWin 
// 

//  Window  Constructor 

WTricWin::WTricWm(2MDL^)pFrame  ♦w,  const  char  ♦title) 

;  zMDIChildFrame(w,ZNEW  zSi2er(zE>ialogUnit(310,0),  zE>ialogUnit(200,155))^TDFRAME,  title)  { 

//  q5b_^gm  WTrkWinConstructor2 

drwRt=500L; 

drwTm=OL; 

#define  TRSR 1 OL  //  this  object  wakes  up  at  the  festest  message  freq. 

//  2pb_end 

deleteOnQose(TRUE); 

menu(ZNEW  zMenu(this,  zRcsId(IDM_TricWinTrkMenu))); 

menuO->setCommand(this,  (CommandProc)&WTrkWin::cmdControlAutoSet,  IDM_CONTROLAUTOSET); 
menu()>>setCommand(this,  (CommandProc)&WTikWin::cmdControlRefresh,  IDM_CONTROLREFRESH); 
menuO->setCoinmand(this,  (CommandProc)&WTrkWin::cmdControlSetup,  IDM_CONTROLSETUP); 
menu(>>>setCommand(dus,  (CommandProc)&WTrkWin::cmdDisplayTrack,  IDM_DISPLAYTRACK); 
pTrkPane  =  ZI^IEW  TrkWinTrkPane(this,  ZNEW  2GravSi2er(ZGRAV_MIDDLE,0^i2erO)); 
pTrkPane->showO; 
sizcrO“>updateO; 

//  zpb_be^  WTrkWinConstmclor 

/^Staticlcon  1  ->backgroundColor(zColor(64,64,64)); 

pSQ->Slp(tiiis.  TRSR);  //wake  window  every  x  ticks 

//  ^b_end 

showQ; 

} 

WTrkWin::-*WTrkWinO  { 

//  zpb^begin  WTrkWinDestnictorl 
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pSQ->Rm(this);  //Remove  this  window  from  the  sleep  queue 

pTQ->^TrkQ(); 

//  zpb_end 

} 

// 

//  Menu  Item  Selection  Handlers 

// 

int  WTrkWin::cmdControIAutoSet(2CommandEvt*  ev)  { 

//  zpb_begin  WTrkWinControlAutoSet 
pTQ->rescaleO; 

//  zpb_end 
return  0; 

} 

int  WTrk^\^::cmdControlRefresh(zCommandEvt*  ev)  { 

DTikRfrh*  p=ZNEW  DTrkRfsh(this,  zResId(IDD__TrkRfsh)); 

p->modal0; 

if  (p->completed0)  { 

//  zpb_begin  WTrkWinControlRefresh 
drwRt  =  (unsigned  long)  atol(p->_DRt); 

//  zpb_end 
}  else{ 

//  qjb^begin  WTricWmControlRefreshCancel 
//  zpb__end 
} 

delete  p; 
return  0; 

} 

int  WTrkWin::cmdControlSetup(zCommandEvt*  ev)  { 

0TkSet*  p=ZNEW  DTkSet(this,  2ResId(II)D_TkSet)); 

p->modal0; 

if  (p->completedO)  { 

//  zpb_begin  WTricWinControlSetup 

pTQ->minlt  =  p->_laMn;  //this  is  for  op  area  field  of  view 

pTQ->maxlt  =  p->_laMx; 

pTQ->minlg  =  p->_lgNfo; 

pT()->maxlg  =  p->_lgMx; 

pTQ->dellt  =  pTQ->maxlt  -  pT(J->minlt; 

pTQ->dellg  -  pTQ->maxlg  -  pTQ->minlg; 

//  2pb_end 
}  else{ 

//  2pb_begin  WTricWinControlSetupCancel 
//  qsb^end 
} 

delete  p; 
return  0; 


int  WTrkWm::cmdDispIayTrack(zCommandEvt*  ev)  { 

ZNEW  WTrkTxt((zMDIAppFrame*)2AppGetAppVar(app)->root^mdowO,  zString(zResId(IDS_TRKTXT))); 
//  iq)b_begin  WTrkWinDisplayTrack 
//  2pb__end 
return  0; 


//  2pb_begin  WTricWinMemberFunctions 
int  WTrkWin:nvakeO{ 

zDrawEvt  *tmpEv; 
if(pSQ->systime  >=  drwTm){ 
pTrid^e->draw(tmpEv); 
drwTm  =  pSQ->systime  +  drwRt; 
}//endif 

return  0; 

}//end  wakeO 
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I  I  q)b_end 


//  Pane  Member  Fimctions  -  SymWinSymPane 

SymWinSymPane::SymWinSyinPane(2Window  ♦w,  zSizer  ^sz) :  zPane(w,  sz,  WS_CHILD)  { 

//  zpb_begin  pSymWinSymPaneConstructorl 

//  ^b_end 

showO; 

} 

int  SymW^SymPane::size(zSizeEvt  ♦ev)  { 
setE)irtyO; 

//  zpb__begin  SymWinSymPaneSize 
//  2pb_end 

return  zWmdow::size(ev); 

} 

int  SymWmSymPane::draw(zDrawEvt*  ev)  { 

canvasO->lockO; 

//  qjb^be^  SymPaneDraw 
//set  up  die  display  parameters 

canvasO->pushFont(new  zFont("Helv",zPrPoint(  1 2^5,canvasO),900,fH)ontCare)); 

//dear  die  window  pane 
zRect  DxTxtArea; 
canvasO->getVisible(DxTxtArea); 
canvasO->i‘ectangle(DxTxtArea); 

can  vasO->text(  1 0, 

10, 

-hello  world"); 


delete  canvasO->popFontO; 
//  zpb_end 
canvasO->unlockO; 
return  1; 


// 

//  Frame  Member  Functions  -  SymWin 
// 

//  Window  Constructor 

WSymU%i::WSymWm(zMDIAppFramc  •w,  const  char  ♦title) 

:  zMDIChildFrame(w,ZNEW  zSizei(zDiaiogUnit(310,0), 

zDialogUnit(200,255)),WS_.CHILD|WS_THICKFRAME|WS_SYSMENU|WS_MINIMIZEBOX|WS_CAPnON,  title)  { 
//  zpb_begin  WSymWtnConstructor2 

//  zpb_end 

deleteOnaose(TRUE); 

menu(ZNEW  zMenu(this,  zRcsId(IDM__SymWmSymMenu))); 

menu()>>setCofnmaiKl(this,  (CoinmandProc)&WSymWm::cmdControlRefiresh,  IDMCONTROLREFRESH); 
pSymPane  =  ZNEW  Sym  WinSyinPane(dus,  ZNEW  zGravSizer(ZGRAV_MIDDLE,0,sizerO)); 
pSymPane*>showO; 

si2£rO>updateO; 

//  zpb_begui  WSym  WinConstructor 

//  2pb_end 

showQ; 


WSymWm::-WSymWmO  { 

//  2pb_begin  WSymWinDestructorl 
//  zpb_end 
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//  Menu  Item  Selection  Handlers 

// 

int  WSymWin::cmdControlRefresh(zCommandEvt*  ev)  { 

DSymRfsh*  p=ZNEW  DSymRfsh(this.  zResId(IDD_SyniRfsh)); 

p->modalO; 

if  (p->completed())  { 

//  2pb_begin  WSymWinControlRefresh 
//  zpb_end 
}  else  { 

//  2pb_be^  WSym  WinControlRefreshCancel 
//  2pb_end 
} 

delete  p; 
return  0; 


//  zpb__begin  WSymWinMemberFunctions 
//  zpb_end 


//  Pane  Member  Functions  -  Del  WinSymPane 

DelWinSymPane::DeIWinS>TnPane(zWindow  zSizer  *sz) :  zPane(w,  sz,  WS__CHILD)  { 

//  zpb_begin  pDelWinSymPaneConstructorl 

//  zpb_end 

showQ; 

} 

int  DeIWinSymPane::size(zSi2eEvt  *ev)  { 
setDirtyO; 

//  zpb_begin  DelWinSymPaneSize 
//  zpb_end 

return  zA\^dow::size(ev); 

} 

int  DelWinSyinPane::draw(zDrawEvt*  ev)  { 
canvasO->lockO; 

//  2pb_begin  SymPaneDraw 
//set  up  die  display  parameters 

canva^>pushFont(newzFont(''Helv”^Point(12^5,canvasO),900.ffDontCare)); 

//clear  die  window  pane 
zRect  DxTxtArea; 
canvasO->getVisible(DxT3ctArea); 
canvasO->rectangle(DxTxtArea); 

canvasO>text(10, 

10. 

TieUo  world"); 


delete  canvasO->popFontO; 
//  ^b_end 
canvasO->unlockO; 
return  1; 

} 


// 

//  Frame  Member  Functions  -  DelWin 

// 

//  Window  Constructor 

WDelWin::WDeIWin(zMDIAppFrame  *w,  const  char  *tide) 

:  2MDIChildFrame(w.ZNEW  zSizer(zDialogUnit(3 10.255), 

zDialogUnit(200,l  12)).WS^CHn-D|WS_.THICICFRAME|WS_SYSMENU|WS_MINIMIZEBOX|WS^CAPTION.  tide)  { 
//  q)b_begin  WDelWinConstnictor2 
//  q)b_end 
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deleteC)nClose(TRUE); 

menu(ZNEW  zMenu(this,  zResId(IDM_DeIWinSymMenu))); 

menuO>setCommand(this,  (ConunandProc)&WDeIMn::ctndControlRefresh,  IDM_CONTROLREFRESH); 
pSymPane  =  ZNEW  DeIWinSymPane(this,  ZNEW  zGravSizer(ZGRAV__MIDDLE,0,sizei<))); 
pSyniPane->show(); 
sizer()->updateO; 

//  q)b_begin  WDelWinConstructor 

//  2pb_end 

showO; 

} 

WDelWinr-WDel^mO  { 

//  2pb_be^  WDel^^^iDestnictorl 
//zpb_end 

} 

// 

//  Menu  Item  Selection  Handlers 
// 

int  WDelWin::cmdControlRefiesh(zCommandEvt*  ev)  { 

DSymRfsh*  p=ZNEW  DSymRfeh(this,  2ResId(IDD__SyniRfsh)); 

p->modalO; 

if(p->comp!etedO)  { 

//zpb_begin  WDelV^ControIRefiesh 
//  zpb_end 
}  else{ 

//zpb_begm  WDelWinControlRefieshCancel 
//  zpb_end 
} 

delete  p; 
return  0; 

} 

//  zpb_be^  WDelWinMemberFunctions 
//  zpb_end 


//  Pane  Member  Functions  -  TrkTxtTkTxPane 

TrkTxtTkTxPane::TricTxtTkTxPane(zWindow  ♦w,  zSizer  ♦sz) :  zPane(w,  sz,  WS_CHILD)  { 

//  q>b_begin  pTrkTxtXkTxPaneConstructorl 

TrkNdx  =  pTQ->newTrkTxt;  //set  the  track  pointer  to  the  New  Track 

//zpb_end 

showO; 

} 

int  TrkTxtTkTxPane::size(zSizeEvt  ♦ev)  { 

setDirtyO; 

//  zpb_begin  TrkTxtTkTxPaneSizc 
//  2pb_end 

return  zWindow::size(ev); 

int  TikTxtTkTxPane::draw(zDrawEvt*  ev)  { 
canvasO->lockO; 

//  zpb^begin  TkTxPancDraw 
//local  constants 

#define  N_TKMSGS  24  //  total  number  of  messages  displayed  on  the  pane 

#define  X_MB  3  //  x  coordinate  for  base  (first  row)  of  display  messages 

#define  Y_MB  10  //  y  coordinate  for  base  (first  row)  of  display  messages 

#defineR_OFF  15  //of&et  for  spacing  between  rows 

//local  variables 

int  tmp_ndx;  //temporary  index 

int  IbufNdx; 

int  r_ndx;  //row  index  for  looping  dirough  the  active  messages  currently  displayed 
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int  r_curr, 

//char  ♦msg_curr[N_TKMSGS]; 


//actual  index  into  the  buffer  of  messages 


//set  up  the  display  parameters 

//can  vas()->pushFont(new  zPontC^Helv^^PointC  1 2^5,canvas()),900,ffDontCare)); 
canvasO->pushFont(newzFont("Helv”^Point(12^5,canvasO),900,fQDontCare)); 

//clear  the  window  pane 
zRect  DxTxtArea; 
canvasO->getVisible(DxTxtArea); 

//canva^>pushPen(new  zPen(zColor(GREEN),  Solid,  5)); 

canvasO->pushBrush(newzBrush(2Color(255,255,255))); 

canvasO->rectangle(DxTxtArea); 

//delete  canvasO->popPenO; 
delete  canvasO->popBrushO; 

//set  up  the  display  parameters 
//  -  select  a  newly  created  font 
//canvasO->backColoitGRAy); 
canvas(>>setTextBackMode(ZTEXT_^TKANSPARENT); 

int  nMsgs; 

if(pTQ->TQ[TrkNdx]->MQndx  <  N_TKMSGS){ 
nMsgs  =  pTQ->TQ[TrkNdx]->MQndx; 
r_ndx  =  0; 

}  else  { 

nMsgs  =N_TKMSGS; 

r_ndx  =  pTQ->TQ[TrkNdx]->MQndx  -  N_^TKMSGS; 

}//endif 


zDimension  txtDim;  //used  to  move  the  draw  origin  as  chars  ou^ut 
int  xdelta;  //number  of  pixels  for  chars  draw  on  a  line 

canvasO->textColor(zColor(0,0,0));  //black  text 
char  ♦ptcl; 
char  ♦ptcO; 
char  ♦ptcml; 

int  numchrs; 

intndx; 

intdsum; 

for(tmp_ndx=(nMsgs-l  );tmp_ndx>*K);tmp_ndx--)  //loop  dirough  die  number  of 
{  //lines  displayed  in  the  window 

r_curr  =  r_ndx+tmp_ndx; 


zPoint  p(  X_MB, 


(Y_MB-K((nMsgs-l)-tmp__ndx)*R_^OFF))); 

int  scnt[LBUFSZ]; 
xdelta  =  0; 

if((nMsgs>  1  )&&(r_cun>0))  { 

ptcl  =  pTQ->TQfrrkNdx}->MQ[r_curr];  //get  pointer  to  line  buffers 
ptcO  =pTQ->TQITrkNdx)->MQ[r_curT-l]; 
numchrs  =  strlen(ptcl ); 
dsum  =  0; 
int  cent; 

foi<ccnt=<);(ccnt<numchrs)&&(ccnt<LBUFSZ);ccnt+^)  { 

iii:  ((*ptcl)!=(*ptc0))){ 
scnt(ccnt]  =1; 

pTQ->TQ[TrkNdx]->CurDeI[ccnt]  =  1; 
dsum-H-;  //this  counts  number  of  chars  not  same 

}else{ 

scnt[ccnt]  =0; 

pTQ->TQ[TrkNdxJ->CurDel[ccnt]  =  0; 

}//endif 

ptcl++; 

ptcO^H-; 

}//endfor 

if((nMsgs>2)&&(r__curr>  1 ))  {  //test  for  "delta  messaging" 
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ptcO  =  pTQ->TQ[TrIcNdx]->MQ[r_curr- 1  ];  //reset  pointer  to  line  buffers 
ptcml  =  pTQ*>TQ[TrkNdx]->MQ[r_curr-2]; 
for(ccntHO;(ccnt<numchrs)&&(ccnt<LBUFSZ);ccnt-H-){ 
if((*ptcO)  N(*ptcml)){ 

pTQ->TQ[TrkN^]->01dDel[ccnt]  =  1; 

}else{ 

pTQ->TQ[TrkNdx]->01dDeI[ccnt]  =  0; 

}//endif 

ptc(^H-; 

ptcml-H-; 

}//endfor 

}//endif 

ptcl  =  pTQ->TQ[TrkNdx]->MQ[r_curr];  //reset  pointer  to  line  buffer 
intpcnt; 
ccnt=0; 

while((ccnt<numchrs)&&(ccnt<LBUFSZ))  { 

pcnt  =  0; 

while(scnt[ccnt]=0)  { 

pcnt-H-;ccnt++; 

}//end>^iiile 

if((pcnt>0)&&(ccnt<=numchrs))  { 
canvasO->textColor(2Color(0,0,0));  //black  text  if  same 
zPoint  dc(p.x0  +  xdelta,p.yO);  ' 
can  vasO->text(dc,ptc  1  ,pcnt); 
txtDiro  -  canvasO->getTextDim(ptcl,pcnt); 
xdelta  +=  (txtDim.widthO-1); 
ptcl  +=  pent; 

}//endif 

if(ccnt<numchrs)  { 

canvas0->textColor(zColor(255,0,0));  //red  text  if  different 

zPoint  ddc(p  jcO  +  xdelta,p.y0); 

canvasO->text(ddc,ptc  1,1); 

txtDim  =  canvasO->getTextDim(ptcl,l); 

xdelta  +=  (txtDim.widthO-1); 

ccnt++; 

ptcl-H-; 

}//endif 

}//endwhile 

int  dmsg  =  0;  //  test  to  see  if  we  have  a  delta  message 
int  tmdel  =  strlen(pTQ->TQ[TrkNdx]->timStr)  +  1; 
for(ccnt=tmdel; 

((ccnt<numchrs)&&(ccnt<LBUFSZ)); 
ccnt++  ){ 

if(  (  pTQ->TQ[TrkNdx]->CurDeI[ccnt]  =  1  )  //we  have  a  new  char 

&&(  pTQ->TQ[TricNdx]->01dDel[ccnt]  =  0  )){ //no  delta  message 
dmsg++; 

}//endif 

(//endfor 
xdelta  *=700; 

ptcl  =  pTQ->TQ[TrkNdx)->MQ[r  curr];  //reset  pointer  to  curr  buffer 
ptcl  tmdel; 

t^dmsg  —  0){  //we  have  a  delta  message 

chardm[8]  =  "!!!"; 

canvas0>>textColor(2Color<0,0,255));  //blue  text 

zPoint  ddc(p  jc()  +  xdelta,p,yO); 

canvasO->text(ddc,dm,  1 ); 

txtDim  =  canvasO>getTextDim(dm,l); 

xdelta  +=  (txtDim.widthQ-l ); 

for(ccnt=tmdeI; 

(ccnt<numchrs)&&(ccnt<LBUFSZ); 

ccnt++  ){ 

if(  pTQ->TQ[TrkNdx]*>01dDel[ccnt]  —  1  ){  //print  die  delta  char 
if(ccnt<numchrs)  { 

canvasO>textColor(zColor(0.0,255));  //blue  text 
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zPoint  ddc(p.x()  +  xdelta,p.y()); 
canvas()->text(ddc,ptc  1,1); 
txtDim  =  canvasO->getTextDim(ptcl,l ); 
xdelta  +=  (txtDim.widthO- 1 ); 

}//endif 

}//endif 

ptcl-H-; 

}//endfor 


}  else  { 

char  dm[8]  =  *»???"; 

canvasO->textColor(zColor(0,0,0));  //black  text 

zPoint  ddc(p.xO  +  xdelta,p.yO); 

canvasO->text(ddc,dm,l); 

txtDim  =  canvasO->getTextDim(dm,l); 

xdelta  +=  (txtDim.widdiO-l); 

}//endif 


} 


//the  following  calculates  values  needed  for  the  analysis  window 
numchrs  -=  100;  //this  adjusts  for  extra  constant  chare  in  the  strings 
ii(numchre<0)  {numchrs=0; } 
if(numchrs<dsum)  {dsum=numchre;} 

pTQ->TQ[TrkNdx]->cCnt[r_curr]  =  numchrs;  //store  total  number  of  chare 

pTQ->TQ[TrkNdx]->dCnt[r_curr]  =  dsum; 

if(numchrs>0){ 

pTQ->TQ[TrkNdx]->csRatio[r_curr]  =  ((£loat)dsum/(float)numchre); 

}else{ 


pTQ->TQ[TrkNdx]->csRatio[r  curr]  =  0.0; 

}//endif 

}else{ 


canvasO->textCoIor(zColor(255,0,0));  //red  text  if  first  message 
canvasO->text(p, 

pTQ.>TQ[TrkNdx]->MQ[r^curr]); 

}//endif 

canvas0->textColor(2Color(0,0,0));  //black  text  is  default 


}//endfor 


delete  canvasO->popFontO; 

//zpb^end 

canvas0->unlock0; 

return  1; 


// 

//  Frame  Member  Functions  -  TrkTxl 

If 

I  I  Window  Constructor 

WTricTxt::WTricTxt(zMDIAppFrame  •w,  const  char  *title) 

:  2MDIChildFrame(w,ZNEW  zSi2eT(zDialogUnit(-2,97), 

zDialogUnit(310,167)),WS_CHILD|WS_THICKFRAME|WS_SySMENU|WS_MINIMIZEBOX|WS_CAPnON,  title)  { 

//  q)b_begm  WTrkTxtConstructor2 
if(pTQ->nTrks>0)  { 
zRect  wsz; 
zCoOrdxd; 
zCoOrdyd; 
getExterior(wsz); 
xd  =  pTQ->xdTrkTxt; 
yd  =  pTQ->ydTrkTxt; 
zPoint  tmppt(xd,yd); 
ws2+=tmppt; 
move(wsz); 
pTQ->xdTrkTxt-=5; 
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pTQ->ydTricTxt  +=  50; 


}//endif 
//  zpb_end 

deleteC)nClose(TRUE); 

backgroundColor(zCoIor(0^55^55)); 

menu(ZNEW  zMenu(this,  zResId(IDM_TrkTxtTkTxMenu))); 

menuO->$etCommand(this,  (CominandProc)&WTrkTxt::cindAnalysisThroughput,IDM_ANALYSISTHROUGHPUT); 
inenuO>setCommand(this,  (CoinmandProc)&WTricTxt::cmdControlRefresh,  IDM_CONTROLREFRESH); 
pTkTxPane  =  ZNEW  TrkTxtTkTxPane(this,  ZNEW  zGravSizer(ZGRAV_MIDDLE,0,sizer())); 
pTkTxPane->show(); 
sizerO->updateO; 

//  ^b_begin  WTrkTxtConstructor 

pTQ->TQ[pTQ->newTrkTxt]->TxWn  =  this;  //this  is  a  message  text  display  window 
pTQ->newTrkAn  =  pTkTxPane->TikNdx; 

ZNEW  WDatAn((zMDIAppFrame*)zAppGetAppVar(app)->rootWindowO,  zString(zResId(IDS__DATAN))); 

//zpb_end 

showO; 

} 

WTrkTxtr-WTrkTxtO  { 

//  zpb_begin  WTiicTxtDestructorl 

pTO->TQ[pTkTxPane->TrkNdx]->TxWn  =  NULL;  //this  is  a  message  text  display  window 
pTkTxPane->TrkNdx  =  0; 

//  zpb_end 

} 

// 

//  Menu  Item  Selection  Handlers 

// 

int  WTrkTxt::cmdAnalysisThroughput(2CommandEvt*  ev)  { 

ZNEW  WDatAn((zMDIAppFrame*)zAppGetAppVar(a¥>p)->rootWindowO,  2String(zResId(IDS_DATAN))); 

//  zpb_begin  WTrkTxtAnalysisThroughput 
//pTQ->newTrkAn  =  pTkTxPane->TrkNdx; 

//zpb^cnd 
return  0; 

} 

int  WTrkTxt::cmdControIRefresh(zCommandEvt*  ev)  { 

DSymRfeh*  p=ZNEW  DSymR£sh(this,  zResId(IDD__SymRfsh)); 

p->modalO; 

if(p->completedO)  { 

//2pb_bcgin  WTrkTxtControlRefresh 
//  q)b_end 
}  else{ 

//  2pb_begin  WTrkTxtControlRefireshCancel 
//zpb  end 

delete  p; 
return  0; 

} 

//  zpb^bcgin  WTrkTxtMcmbcrf^unctions 

int  WTrkTxCTirdrwO  { 

zDrawEvt  •dummyEv; 

pTkTxPane->draw(dummyEv);  //the  draw  routine  does  not  use  this  input  param 

//  zApp  uses  this  as  an  event  token  for  its 
//  own  dispatching. 

return  0; 

}//end  rtrdrwO 

//  zpb_cnd 


//  Pane  Member  Functions  •  DatAnDatAnPane 


141 


DatAnDatAnPane::DatAnDatAnPane(zWindow  ♦w,  zSizer  *sz) :  zPane(w,  sz,  WS_CHILD)  { 

//  zpb_begin  pDatAnDatAnPaneConstructorl 
Tri^dx  =  pTQ«>newTrkAn; 

//  zpb_end 
showO; 

} 

int  DaiAnDatAnPane::size(zSizeEvt  *ev)  { 
setDirtyO; 

//  zpb_begin  DatAnDatAnPaneSize 
//  zpb_end 

return  zWindow::size(ev); 

} 

int  DatAnDatAnPane::draw(zDrawEvt*  ev)  { 
canvasO->lockO; 

//  2pb_begm  DatAnPaneDraw 
//local  constants 

#define  N_TKMSGS  24  //  total  number  of  messages  displayed  on  the  pane 

#define  X_MB  3  //  x  coordinate  for  base  (first  row)  of  display  messages 

#define  Y_MB  10  //  y  coordinate  for  base  (first  row)  of  display  messages 

#defineR_OFF  15  //offset  for  spacing  between  rows 

//local  variables 
int  tmp^ndx; 
int  IbufNdx; 
int  r_ndx; 
intrcurr; 

//char  *msg^curr[N_TKMSGS]; 

//set  up  the  display  parameters 

//canvasO>pushFont(new  zFont("Helv"^Point(12;25,canvasO),900,ffDontCare)); 
canvas()->pushFont(newzFont("Helv"^Point(12^5,canvasO),900,ffDontCare)); 

//clear  the  window  pane 
zRect  DxAnArea; 
canvasO>getVisible(I>xAnArea); 

//canvas()->pushPen(new  zPen(zColor(GREEN)»  Solid,  5)); 
canvas()->pushBrush(new  zBrush(LiteGrayBrush)); 
canvasO->rectangle(PxAnArea); 

//delete  canvas()->popPenO; 
delete  canvasO>popBrushO; 

canvas(>>setTextBackMode(ZTEXr_TRANSPARENT); 

intnMsgs; 

if(pTQ->TQ[TrkNdx]->MQndx  <  N_TKMSGS){ 
nMsgs  =  pTQ->TQ[TricNdx]->MQndx; 
r_ndx  =  0; 

}clse{ 

nMsgs  =  N_TKMSGS; 

r^ndx  =  pTQ->TQ[TrkNdxl->MQndx  -  N_TKMSGS; 

}//endif 

chartbuf[256]; 
diartmp[16]; 

ostrstream  tmpst]ttbufi$trlen(tbuf)); 
int  x_margin; 

x_margin  =  int  (0.05*((float)DxAnArea.widthO)); 
inty_mar^n; 

y_margin  =  int  (0.125*((float)DxAnAreaJieightO)); 
int  c^off; 

c_off  =  int  (0.9*((float)DxAnArea.widthO)/N_TKMSGS); 
int  maxchrs  =  30; 


//temporary  index 

//row  index  for  looping  through  die  active  messages  currently  displayed 
//actual  index  into  die  buffer  of  messages 
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int  y_unit; 

y^unit  =  (DxAnArea,heightO-  (2*y_margin))/maxchrs; 
canvasO->text(5, 

5, 

pTQ->TQ[TrkNdx]->niiniStr); 

canvasO->text(50, 

5, 

pTQ->TQ[TrkNdx]->timStr); 

for(tmp_ndx=(nMsgs«l);tmp_ndx>=0;tmp_ndx~)  //loop  through  the  number  of 
{  //lines  displayed  in  the  window 

r_cuiT  =  r_ndx+tmp__ndx; 

if((nMsgs>  1  )&&(r_curr>0))  { 

canvasO->pushPen(new  2Pen(zColor(GREEN),  Solid,  5)); 
canvasO->moveTo(x_margin-»-((((nMsgs-l)-tmp_ndx)*c_off)), 

£)xAnArea.bottomO  -  y_margin  ); 

//tmpstr  «  dec  «  pTQ->TQ[TrkNdx]">dCnt[r_curr]«"\0”; 

//strcpy(tmp,tbuf); 

//Int  Aufiidx  =  strlen(tmp)- 1 ; 

//tmp[tbufiidx]='\0‘; 

canvasO->lineTo(x_margin-K(((nMsgs- 1  )-tmp_ndx)*c__off)), 

( (DxAnArea.bottomO  -  y_margin  ) 

-^__unit  ♦  pTQ->TQ[TrkNdx]->cCnt[r_cuir]))); 

delete  canvas(}->popPenO; 

canvasO->pushPen(new  zPen(zColor(RED),  Solid,  5)); 
canvas(>->moveTo(x_margin+((((nMsgs- 1  >-tmp_ndx)*c_off)), 

DxAnArea.bottomO  -  y_margin  ); 

canvasO->lineTo(x_margin+((((nMsgs-l)-tmp_ndx)*c_off)), 

( (DxAnArea.bottomO  -  y_margin  ) 

-(y_unit*pTQ->TQ[TrkNdx]->dCnt[r_curr]))); 

delete  canvasO->popPenO; 

//pTQ->TQ[TikNdx]->cCnt[r_curr];  //store  total  number  of  chars 
//pTQ»>TQ[TrkNdx]->dCnt[r_curr]  =  dsum; 

//if(numchr^){ 

//pTQ->TQ[TricNdx]->csRatio[r_cuiT]  =  ((float)dsum/(float)numchrs); 

//}else{ 

//  pTQ’>TQ[TrkNdx]->csRatio[r  curr]  =  0.0; 

//}//endif 

}else {  //this  is  die  last  message 

//canvasO->textColor(zColoi(255,0,0));  //red  text  if  first  message 
//canvasO->text(p, 

//  "Insufficient  Data  for  Analysis"); 

}//endif 

canvasO>textColoi<zColor(0,0,0));  //black  text  is  de&ult 
}//endfor 

delete  canvasO->popFontO; 

//  qib^end 

canvas0->unlock0; 

return  1; 


// 

//  Frame  Member  Functions  -  DatAn 
// 

//  Window  Constructor 

WDatAn::WDatAn(zMDlAppFrame  ♦w,  const  char  ♦title) 

:  zMDIChildFrame(w,ZNEW  zSizer(zDialogUnit(310,155), 

2DiaIogUnit(100,100)),WS_Cm.D|WS_TfflCKFRAME|WS_SYSMENU|WS_,MINIMIZEBOX|WS_CAPTION,  title)  { 
//  zpb_begin  WDatAnConstructor2 
//  qib_cnd 

deleteOnClose(TRUE); 

backgroundColoi<2Coloi(0,255,255)); 
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menu(ZNEW  zMenu(this,  zResId(IDM_DatAnDatAnMenu))); 

menu()->setCommand(this,  (CommandProc)&WDatAn::cmdControIRefresh,  IDM_CONTROLREFRESH); 
pDatAnPane  =  ZNEW  DatAnDatAnPane(this,  ZNEW  zGravSizer(ZGRAV_MIDDLE,0,sizer())); 
pDatAnPane->show(); 
sizer()->update(); 

//  2pb_begin  WDatAnConstructor 

pTQ->TQ[pTQ->newTricAn]->AnWn  =  this;  //this  is  a  track  analysis  window 

//  2pb_end 

show(); 

} 

WDatAn::~WDatAnO  { 

//  2pb_begm  WDatAnDestructorl 
pTQ->TQ[pDatAnPane->TrkNdx]->AnWn  ==  NULL; 

//  zpb_end 

} 

// 

//  Menu  Item  Selection  Handlers 

// 

int  WDatAn::cmdControIRefresh(zCommandEvt*  ev)  { 

DSymRfsh*  p=ZNEW  DSymRfsh(this,  2ResId(IDD_SymRfsh)); 

p->modaI0; 

if  (p->completed())  { 

//  zpb_begm  WDatAnControlRefresh 
//  2pb_end 
}  else  { 

//  q3b_begin  WDatAnControlRefireshCancel 
//  zpb_end 
} 

delete  p; 
return  0; 

} 

//  zpb_begin  WDatAnMemberFunctions 
int  WDatAnrrrtrdrwQ  { 

zDrawEvt  ♦dummyEv; 

pDatAnPane->draw(dummyEv);  //die  draw  routine  does  not  use  diis  input  param 

//  zApp  uses  this  as  an  event  token  for  its 
//  own  dispatching 

return  0; 

}//end  rtrdrwO 

//  q3b_end 


//  Pane  Member  Functions  >  jtidssldjpane 

jtidssldjpane::jtidssldjpane(z)\^mdow  *w,  zSizer  ♦sz) :  zPane(w,  sz,  WS^CHILD)  { 

//  zpb_begin  pjtidssldjpaneConstructorl 

pjimg  =  new  zBitm^canvasQ,  "bground00.bmp’*); 

//  q)b_end 
showQ; 


intjtidssldjpane;:size(zSi2eEvt  *ev)  { 
setDiityO; 

//  zpb__begin  jtidssldjpaneSize 
//  2pb_end 

return  zWindow::size(ev); 


int  jtidssldjpane::draw(zDrawEvt^  ev)  { 
canvas()->lockO; 

//  :q)b_begin  jpaneDraw 

canvasO>bitmap(pjimg;zPoint(0,0),  SRCCOPY); 
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} 


//  zpb__end 
canvasO->unJockO; 
return  1; 


// 

//  Frame  Member  Functions  -  jtidssld 

// 

//  Window  Constructor 

\\^tidssId:;)A^dssld(zMDIAppFrame  ♦w,  const  char  *title) 

:  2MDIChadFiame(w,ZNEWzSizei(2DiaIogUnit(0,0),  zDialogUnit(517,412)),WS_CHILD,  title)  { 

//  zpb_be^  >^^tidssldConstructor2 
//  zpb_end 

deleteOnClose(TRUE); 

menu(ZNEW  zMenu(this,  zResId(IDMJtidssldjmenu))); 

menuO->setCommand(this,  (0)mmandProc)&WjtidssId::cmdInfoDInfo,  EDM^INFODINFO); 
menuO->setCommand(this,  (CommandProc)&)\^tidssld::cmdInfoDIInfo,  IDM^INFODIINFO); 
pjpane  =  ZNEW  jtidssldjpane(this,  ZNEW  2Si2er(zDialogUnit(0,0),zDialogUmt(5 17,412))); 
pjpane->showO; 

//q5b_begin  WjtidssIdConstructor 

//  zpb_end 

showQ; 

} 

Wjtidssld::-^)\5ti<lssld0  { 

//2pb_begin  WjtidssldDestructorl 
//  q>b_end 

} 

// 

//  Menu  Item  Selection  Handlers 
// 

int  ^tidssId::cmdInfoDInfo(zCommand£vt*  ev)  { 

DDDinfo*  p=ZNEW  DDOinfo(this,  zResId(IDD_DDinfo)); 

p->modalO; 

if  (p->completedO)  { 

//2pb__begin  >\QtidssldInfoDlnfo 
//2pb_end 
}  else  { 

//  ^b_begm  ^tidssldlnfoDInfoCancel 
//  zpb_end 
} 

delete  p; 
return  0; 

} 

int  Wjddssld::cmdInfoDIInfo(2CommandEvt*  ev)  ( 

DDDIInfo*  p=ZNEW  DDDIInfo(this,  2ResId(IDD_DDIInfo)); 

p->modal0; 

if  (p->completedO)  { 

//  ^b_be^  WjtidssldlnfoOIInfo 
//  zpb_end 
}  else{ 

//  zpb^bcgin  ^ddssIdlnfoDIInfoCancel 
//zpb  end 
} 

delete  p; 
return  0; 


//  2pb_begin  >^dssldMemberFunctions 
int  >A^tidssld::dinfo(DDI>info  *DDptr)  { 

//DDDinfo  ♦DDptr; 

DDptr->_mmHgt  =  pjpane->canvasO->mmHeightO; 
DDptr->_mmWth  =  pjpane->canvasO>mmWidth(); 
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DDptr->_pxHgt  =  pjpane->canvas()->pixHeight(); 
DE^tr->_pxWth  =  pjpane~>canvasO->pixWidth(); 
DDptr->j5xPinX  =  pjpane->canvasO->pixPerInchX(); 
DDptr->_pxPmY  =  pjpane->canvasO->pixPerInch  YQ; 
DDptr->_pfin  =  pjpane->canvasO->polyFillMode(); 
return  0; 


int  )^tidss!d::diinfo{DDDIInfo  ♦DDIptr)  { 

//DDDinfo  *DDptr; 
zDisplayInfo  *zdisptr; 

zdisptr  =  ZNEW  zDisplayInfo{pjpane->canvasO); 
int  numclr; 

zdisptr->IockO; 

numclr  =  zdisptr->colorResO; 

DDIptr->_aspectX  =  2disptr->aspectX0; 

DDIptr->_aspectXY  =  zdisptr->aspectXYO; 

DDIptr->_aspectY  =  2disptr->aspectY0; 

DDIptr->_colorPlanes  =  zdisptr~>colorPIanesO; 

DDIptr->_colorRes  =  zdisptr->colorResO; 

DDIptr->_numcolors  =  zdisptr->numColorsO; 

DDIptr->_pixDepth  =  zdisptr->pixDepthO; 
zdisptr->unlockO; 

//chard)uf[256]; 

//ostrstream  tmpstr(tbuf;  256); 

//tmpstr «  numclr  «  ends; 

//zString  sbuf  =  ” 

//sbuf  =  ibuf; 

//canvasO>pushFont(new2Font("He!v"^Pomt(12»25,canvasO),900,ffDontCare)); 
//canvasO“>  text(5,5,sbuf); 

//delete  canvasO->popFontO; 


return  0; 

} 

//  zpb_end 
// 

//  Dialog  Member  Functions  -  About 

// 

DAbout::DAbout(2>^^dow  ♦w,const  zResId&  rid) :  zFormDialog(wjid)  { 

//  zpb_begin  DAboutConstructor2 
//q)b_end 

//  q)b_begin  DAboutConstructor 
//2pb_end 

centerWindow(this);  //  Center  window  on  parent 

showO; 


//  zpb_begin  DAboutMemberFunctions 
//zpb_end 

// 

//  Dialog  Member  Functions  -  MsgR&h 

// 

DMsgRfeh::DMsgRfeh(2)Mndow  ♦w^const  zResld&  rid) :  zFormDialog(w^d)  { 
//  zpb__begin  DMsgRf5hConstnictor2 
//q)b__end 

pDRt  =  ZNEW  2ComboBoxStatic(this,  ID__DRT.  &_^DRt); 
pDRt->add(zString(zResId(IDS_MSGRFSHDRT_l ))); 
pDRt->add(2String(2ResId(IDS_MSGRFSHDRT^2))); 
pDRt->add(2String(zResId(IDS_MSGRFSHDRT_3))); 
pDRt->add(zString(zResId(IDS__MSGRFSHDRT_4))); 

//  2pb_begin  DMsgRfaiConstnictor 
WDxWin 
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tptr  =  (WDxWin  ♦)  w; 
long  tmpval; 

tmpval  =  (long)tptr->drwRt; 

CurRt(tmpval); 

pDRt->setToE>efault(); 

//  zpb_end 

centerWindow(this);  //  Center  window  on  parent 

showO; 

} 

//  zpb__begin  DMsgRfshMemberFunctions 
int  DMsgR£5h::CurRt(long  CRt){ 
chartbuf[256]; 

ostrstream  tmpstr(tbuf^trlen(tbuf)); 
tmpstr«dec«CRt; 
strq)y(_DRt,tbuf); 
return  0; 

}//end  CurRtO 
//  zpb_end 

// 

//  E>ialog  Member  Functions  -  MsgRate 

// 

DMsgRate::DMsgRate(zWmdow  ♦w,const  zResId&  rid) :  zFonnDialog(w^d)  { 

//  q3b_begin  DMsgRateConstructor2 
//  zpbjsnd 

pMrt  =  ZNEW  zComboBoxFull(this,  ID_MRT,  &_Mrt); 

pMrt->add(zString(zResId(IDS_MSGRATEMRT_l ))); 

pMrt*>add(zString(zResId(IDS_MSGRATBMRT_2))); 

pMrt->add(zString(zResId(IDS__MSGRATEMRT3))); 

pMrt“>add(zString(zResId(IDS_MSGRATEMRT_4))); 

pNfrt->add(2String(zResId(IDS_MSGRATEMRT_5))); 

pMrt->add(zString(zResId(IDS_MSGRATEMRT_6))); 

pMrt->add(zString(2ResId(IDS_MSGRATEMRT_7))); 

pMrt->add(zString(zResId(IDS__MSGRATEMRT_8))); 

pMrt->add(2Strmg(zResId(IDS_MSGRATEMRT__9))); 

pMrt->add(2String(zResId(IDS_MSGRATEMRT_l  0))); 

//  q)b_begin  DMsgRateConstnictor 
WDxWin  ♦tptr; 

^tr  =  (WDxWin  •)  w; 
long  tmpval; 

tmpval  =  (iong)tptr->nisgRt; 

CurRl(tmpval); 

pNfrt“>setToDefeultO; 

//  zpb__end 

centerWindow(this);  //  Center  window  on  parent 

showQ; 

} 

//  q)b_begin  DMsgRateMemberFunctioQS 
int  DMsgRate::CurRt(Iong  CRl){ 
char  tbufI256]; 

ostrstream  tmpscr(tbuf,5trien(tbuf)); 
tmpstr «  dec  «  CRt; 
strcpy(_Mrttbuf); 

return  0; 

}//cnd  CurRtO 
//  zpb_end 

// 

//  Dialog  Member  Functions  -  Tlnfo 

// 

DTlnfo::DTInfo(zWindow  *w,const  zResId&  rid) :  zFonnDiaIog(w»rid)  { 

//  zpb_begin  D‘nnfoConstructor2 

//  folio\^g  fragment  shows  how  to  create  and  delete  this  dialog 
//ref  only:  DTInfo*  p=ZNEW  DTInfo(this,  zResId(IDD_TInfo)); 
//ref  only:  p->modal(); 
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//ref  only:  if  (p->completecl())  { 

//  2pb__  TrkWinTrkPaneLButtonDown 

//ref  only: } 

//ref  only:  delete  p; 

//  zpb^end 

pETAIt  =  ZNEW  zEditLine(this,  ID^ETALT,  &_ETAlt,  FLD__NOTREQUIRED); 
pETTyp  =  ZNEW  zEditLine(this,  ID_ETTYP,  &_ETTyp,  FLD^NOTREQUIRED); 
pETNum  =  ZNEW  zEditLine(tfiis,  ID_.ETNUM,  &_ETNum,  FLD^NOTREQUIRED); 
pETSpd  =  ZNEW  zEditLme(this,  ID^ETSPD.  &_ETSpd,  FLD__NOTREQUIRED); 
pETlocx  =  ZNEW  2EditLine(this,  ID_ETLC)CX,  &_ETlocx,  FLD_NOTREQUIRED); 
pETlocy  =  ZNEW  2EditLine(this,  ID^ETLOCY,  &_ETlocy,  FLD_NOTREQUIRED); 
pDType  ==  ZNEW  2ComboBoxStatic(this,  ID_DTYPE,  &_DType); 
pDType->add(zString(zResId(IDS_TINFODTYPE_l))); 
pDType->add(2String(zResId(roS_TINFODTYPE__2))); 
pDType->add(zStrmg(zResId(IDS_TINFODTYPEJ))); 
pDType->add(zString(zResId(IDS_TINFODTYPE_4))); 
pDType->add(zStrmg(zResId(IDS_TINFODTYPE_5))); 
pDType->add(zStrmg(zResId(IDS_.TINFODTYPEl6))); 
pDType->add(zStrmg(zResId(IDS.TINFODTYPE_7))); 
pDType->add(zStrmg{zResId^S_TINFODTYPE_8))); 
pDType->add(zString(zResId(IDS_TINFODTYPE_9))); 

//  zpb^begin  DTInfoConstructor 

int  dnx  =  pTQ->DTindx; 

CrVl(_ETAlt,  pTQ-'>TQ[dnx]->altRaw); 
pETAlt->setToDefaultO; 

strcpy(_ETTyp,  pTQ->TQ[dnx]->typStr); 

pETTyp->setToDefaultO; 
strcpy(_ETNum,  pTQ->TQ[dnx]->numStr); 
pETNum->setToDefaultO; 

CrVl(_ETlocx,  pTQ->TQ[dnx]->xRaw); 
pETlocx->setToDefaultO; 

CrVl(_ETlocy,  pTQ->TQ[dnx]->yRaw); 
pETlocy->setToDefaultO; 

CrVI(_ETSpd,  pTQ->TQ[dnx]->spRaw); 
pETSpd->setToDefeultO; 
strcpj^DType,  pTQ->TQ[dnx]->dTypStr); 
pDType->setToDefaultO; 

//  2pb_end 

centerWmdow(tiiis);  //  Center  window  on  parent 

showO; 


//  q)b_begin  DTInfoMemberFunctions 
int  DTInfo::CrVl(char  ♦cvbufi  float  cv){ 
chard)uf[256]  =  " 
ostrstieam  tmpstr(tbiif;strlen(d>uf)); 
tmpstr  «  cv; 
strcpy(cvbuf;d)uf); 
return  0; 

}//endCrV10 

int  DTInfo::UpdAtt(char  •typstr){ 
int  tmptype; 

tmptype  =  pDType->seIectionO; 
switch(tmptype)  { 

case  HOSTILE_AIR; 

strcpy(typstr,  "HOSTILE  AIRCRAFT); 
break; 

case  HOSTILE_SUB: 

strcpy(typstr,  "HOSTILE  SUBSURFACE"); 
break; 

case  HOSTILE^SURFACE: 

strcpy(typstr,  "HOSTILE  SURFACE"); 
bre^ 

case  UNKNOWN^AIR: 

strcpy(typstr,  "UNKNOWN  AIRCRAFT); 
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break; 

caseUNKNOWN^SUB: 

strcpy(typstr,  'TJNKNOWN  SUBSURFACE"); 
break; 

case  UNKNOWN_SURFACE: 

strcpy(typstr,  "UNKNOWN  SURFACE"); 
break; 

case  FRBENDLYAIR: 

strcpy(typstr,  "FRIENDLY  AIRCRAFT"); 
break; 

case  FRIENDLY_SUB: 

strcpy(typstr,  "FRIENDLY  SUBSURFACE"); 
break; 

case  FRIENDLY_SURFACE: 

strcpy(typstr,  "FRIENDLY  SURFACE"); 
break; 

};  //end  case  statement 

//slrcpy(typstr,  "HOSTILE  AIRCRAFT"); 
return  tmptype; 

}//endCrV10 
//  zpb_end 

// 

//  Dialog  Member  Functions  -  SymRfsh 
// 

DSymRfsh::DSymRfeh(zWindow  ♦w,const  zResId&  rid) :  zFormDialogCw^d)  { 

//  2pb_begin  DSymRfshConstnictor2 
//  zpb^end 

pDRt  =  ZNEW  zComboBoxStatic(tiiis,  ID_DRT,  &_DRt); 

pDRt->add(zString(zResId(IDS_SYMRFSHDRT_l))); 

pDRt->add(zString(2ResId(IDS_SYMRFSHDRT_2))); 

pDRt->add(zString(zResId(IDS_SYMRFSHDRT_3))); 

pDRt->add(zString(zResId(IDS_SYMRFSHDRT_4))); 

//  :q)b_begin  DSymRfshConstructor 
//  zpb_end 

centerWindow(this);  //  Center  window  on  parent 

showQ; 

} 

//  zpb_begin  DSymRfehMemberFunctions 
//  2pb_end 

// 

//  Dialog  Member  Functions  -  TricRfeh 
// 

DTrkRfeh::DTricRfeh(z>\%idow  *w,const  zResId&  rid) :  zFormDialog(w^d)  { 

//  zpbjye^  DTricRfehConstmctor2 
//  ^b__end 

pDRt  =  ZNEW  zComboBoxStatic(this,  ID_DRT,  &_DRt); 
pDRl->add{zString(zResId(IDS_TRKRFSHDRT_l ))); 
pDRt->add(zString(zRcsId(IDSlTRKRFSHDRT_2))); 
pDRt->add(zString(zResId(IDS^™KRFSHDRT_3))); 
pDRt->add(zStrmg(2ResId(IDS_TRKRFSHDRT_4))); 

//  zpb_begin  DTrkRj&bConstructor 
WDxWin  *tptr. 
tptr  =  (WDxWin  •)  w; 
long  tmpval; 

tmpval  =  (long)tptr->drwRt; 

CurRt(tmpval); 

pDRl->setToDefeultO; 

//  zpb_end 

centerWindow(tiiis);  //  Center  window  on  parent 

showQ; 

} 

//2pb_begin  DTrkRfshMemberFunctions 
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int  DTrkRfsh::CurRt(Iong  CRt){ 
char  ti)ufl256]; 

ostrstream  tmpstr(tbuf,strlen(tbuf)); 
tmpstr  «  dec  «  CRt; 
strcpyC_DRt,tbuf); 
return  0; 

}//end  CurRtO 
//  qDb_end 

If 

//  Dialog  Member  Functions  -  TkSet 
// 

DTkSet:DTkSet(2Wmdow  ♦w,const  zResId&  rid) :  zFomiDiaIog(w^d)  { 

//  zpb_begin  DTkSetConstructor2 
//  zpb_end 
_la^  =  0; 

_iaMx  =  0; 

JgMn  =  0; 

JgMx  =  0; 

plaMn  =  ZNEW  zFloatEdit(this,  ID__LAMN,  &_laMn,  "-#######.##«,  FLD^NOTREQUIRED) 
plaMx  =  ZNEW  zFloatEdit(this,  ID^LAMX,  &JaMx,  ”-MffffiffUfM\  FLD_NOTREQUIRED) 
plgMn  =  ZNEW  2f  IoatEdit(this,  ID__LGMN,  & JgMn,  FLD^NOTREQUIRED) 

plgMx  =  ZNEW  zFloatEdit(this,  ID^LGMX,  &  JgMx,  "-#######.##••,  FLD_NOTREQUIRED) 
//  zpb^begin  DTkSetConstructor 

_IaMn  =  pTQ->minlt;  //this  is  for  op  area  field 

_laMx  =  pTQ->maxlt; 

_lgMn  =  pTQ->minlg; 

_lgMx  =  pTQ->maxIg; 

plaMn->setToDefaultO; 

pIaMx->setToDefaultO; 

plgMn->setToDefaultO; 

plgMx->setToDefeultO; 

//2pb_end 

center)\%idow(this);  //  Center  window  on  parent 

showQ; 

} 

//  zpb_begin  DTkSetMemberFunctions 
//  zpb_end 

// 

//  Dialog  Member  Functions  -  Rescale 
// 

DRescale::DRescale(zWindow  ♦w,const  zResld&  rid) ;  zFomiDialog(w^d)  { 

//  q5b_begin  DRescaleConstructor2 
//  2pb_end 
_laMn  =  0; 

IlaMx  =  0; 

_lgMn  =  0; 

_lgMx  =  0; 

plaMn  =  ZNEW  zFloatEdiKthis,  ID_LAMN,  &_laMn,  "-#######.##«,  FLD_NOTREQUIRED); 
plaMx  =  ZNEW  zFloatEdit^this,  ID_LAMX,  &_IaMx,  "4^######.##",  FLD__NOTREQUIRED)* 
pIgMn  =  ZNEW  zFloatEdit(this,  ID^LGMN,  & JgMn,  "-#######.##",  FLD^NOTREQUIRED); 
plgMx  =  ZNEW  zFloatEditCthis,  ID^LGMX,  & JgMx,  "-#######.##",  FLD_NOTREQUIRED); 
//  q5b_begin  DRescaleConstructor 
pT(^>rescaleO; 

_laMn  =  pTQ->tninlt;  //this  is  for  op  area  field 

_laMx  =  pTQ->inaxlt; 

_lgMn  =  pTQ->minlg; 

_lgMx  “  pTQ->maxlg; 

plaMn->setToDefeultO; 

plaMx->setToDefeultO; 

plgMn->setToDefeultO; 

plgMx->setToDefaultO; 

//  zpb__end 

centerWindow(this);  //  Center  window  on  parent 

showQ; 
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} 


//  zpb^begin  DRescaleMemberFunctions 
//  q)b_end 

// 

//  Dialog  Member  Functions  -  FxdFmt 

// 

DFxdFmt*:DFxdFmt(zMDIAppFrame  ♦w,const  2ResId&  rid) :  zMDIFormDialog(w^d)  { 

//  2pb_begin  DFxdFmtConstructor2 
//  2pb_end 

//  zpb_begin  DFxdFmtConstructor 

//  ^b_end 

showO; 

} 

//  zpb^begin  DFxdFmtMemberFunctions 
//  zpb_cnd 

// 

//  Dialog  Member  Functions  -  DDinfo 

// 

DDDinfo::DDDinfo(2Window  *w, const  zResId&  rid) :  zFormDialog(w^d)  { 

//  zpb^begin  DDDinfoConstructor2 

Wjtidssld  *wptr; 

wptr  =  ((Wjtidssld  *)  w); 

//_Editl  =  wptr>>pjpane->canvasO->mmHeightO; 
intstat; 

stat  =  wptr->dinfo(this); 

//  zpb_end 
_mmHgt  ~  0; 

_mmWth  =  0; 

_pxHgt  =  0; 
j)xWth  =  0; 

_pxPinX  =  0; 

_pxPinY  =  0; 
jpfioa  =  0; 

pmmHgt  =  ZNEW  zIntEdit(this,  ID_MMHGT,  &_mmHgt,  "#####",  FLD^NOTE^QUIRED); 
pmmWth  =  ZNEW  zIntEdit(this,  ID^MMWTH,  &^mmWth,  "#####”,  FLD__NOTREQUIRED); 
ppxHgt  =  ZNEW  zIntEdit(this,  ID_PXHGT,  & jJxHgt,  "#####",  FLD^NOTREQUIRED); 
ppxWth  «  ZNEW  2lntEdit(dus,  ID_PXWTH,  &_J)xWth,  "#####",  FLD__NOTREQUIRED); 
ppxPinX  =  ZNEW  zIntEdit(this,  ID_PXPINX,  &_pxPinX,  "#####",  FLD_.NOTREQUIRED); 
ppxPinY  =  ZNEW  2lntEdit(this,  ID_PXPINY,  &_pxPinY,  "#####",  FLD^NOTREQUIRED); 
ppfin  =  ZNEW  zIntEdit(dus,  ID_PFH  & jfin,  "#####",  FLD__NOTREQUIRED); 

//  2pb_begin  DDDinfoConstnictor 
//  zpb_cnd 

centerWindow(this);  //  Center  window  on  parent 

showO; 

} 

//  2pb_begm  DDDinfoMemberi^unctions 
//2pb_end 

// 

//  Dialog  Member  Functions  -  DDIlnfo 

// 

DDDnnfo::DDDQnfo(zWindow  *w,const  zResId&  rid) :  zFonnDialog(w4id)  { 

//  zpb_begin  DDDIInfoConstructor2 

\\Qtidssld  ♦wptr, 

wptr  =  ((Wjtidssld  •)  w); 

//_Editl  =  wptr->pjpane->canvasO->inmHeightO; 
intstat; 

stat  =  wptr->diinfo(this); 

//  zpb__cnd 
_aspectX  =  0; 

_aspectXY  =  0; 

_aspectY  =  0; 
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_colorPlanes  =  0; 

_colorRes  =  0; 

_numcolors  =  0; 

__pixDepth  =  0; 

paspectX  =  ZNEW  2lntEdit(this,  ID^^ASPECTX,  &_aspectX,  "#####",  FLD_.NOTREQUIRED); 
paspectXY  =  ZNEW  zIntEdit(this,  ID^ASPECTXY,  &_aspectXY.  "#####",  FLD^NOTREQUIRED); 
paspectY  =  ZNEW  zIntEdit(this,  ID__ASPECTY,  &__aspectY,  "#####",  FLD_NOTREQUIRED); 
pcolorPlanes  =  ZNEW  zIntEdit(this,  ID_COLORPLANES,  &_colorPlanes,  "#####",  FLD__NOTREQUIRED); 
pcoIorRes  =  ZNEW  zIntEdit(this,  ID^COLORRES,  &__colorRes,  ”#####",  FLD_NOTREQUIRED); 
pnumcolors  =  ZNEW  zIntEdit(this,  ID_NUMCOLORS,  &__numcoIors,  "#####",  FLD^NOTREQUIRED); 
ppixDepth  =  ZNEW  2lntEdit(this,  ID^PIXDEPTH,  &j5ixDepth,  "#####",  FLD^NOTMQUIRED); 

//  zpb_begm  DDDIInfoConstructor 
//qjb^end 

center>\^mdow(this);  //  Center  window  on  parent 

showQ; 

} 

//  ^b^begin  DDDIInfoMemberFunctions 
//  zpb_end 


// 

//  Simple  function  to  center  window  within  parent  or  screen 

// 

void  centerWindow(2^mdow  ♦w,  BOOL  fOnParent)  { 
zRect  winRect,  parentRect; 
int  xWin, 

w->getExterior(winRect); 
zSystemInfo  screen; 

if  (fOnParent  &&  w->parent0)  { 

//  retrieve  parent  rectangle 
w->paren^>getExterior(parentRect); 

//  center  witiiin  parent  window 

xWin  =  parentRectleftO  +  ((parentRectwidthO  -  winRectwidthO)/2); 
y Win  =  parentRecttopO  +  ((parentRectheigh^  -  winRectheightO)/2); 

//  adjust  win  x-location  for  screen  size 

if  (  xWin+winRecLwidtiiO  >  screen.pix>\^dthO ) 

xWin  =  screen.pix^^ldthO  -  winRectwidthQ; 


//  adjust  win  y-location  for  screen  size 

if  ( yWin+winRectheightO  >  screen.pixHeightQ ) 

y  Win  =  screen.pbcHeightO  -  winRectheightO; 

else  { 

//  center  within  entire  screen 

xWin  “  (screen.pixWidthO  -  winRectwidthQ)  /  2; 

y  Win  =  (screen.pixHeightQ  -  winRectheigh^)  /  2; 

//  move  window  to  new  location 
w->move(  (xWin>0)  ?  xWin  :  0, 

(yWin>0)?yWin:0. 

winRectwdthQ, 

winRectheightQ); 

// 

//  Bitmap  Pane  Member  Functions 

// 

zfBitm^Pane::zfBitmapPane(zWindow*  w,  const  zResId  &id,  zSizer*  sz) 

:2Pane(w,  sz),  tiieBitmap(id)  { 
showQ; 

} 
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int  2fBitmapPane::draw(zI>rawEvt  ^e)  { 
zRectr; 

getInterior(r);  //  Draw  entire  bitmap 

canvasO->lockO; 

zBitmapDisplay  *bd; 

bd  =  Zl^W  2BitmapDispIay(&theBittn^); 
bd->IockO; 

bd->copyTo(canvasO,  r.leftO>  r.topO, 

theBitm^.size0.widA0,  theBitmap.sizeQ  JieightQ,  0, 0); 

bd->setBitmap(0); 

bd->unlock0; 

delete  bd; 

canvas0->unlock0; 
return  TRUE; 

} 

//  zpb^begin  AppUserCode 
//  zpb_end 

// 

//  Application  Entry  Point 

// 

void  zApprrmainQ  { 

initlntPackQ; 

//  zpb^begin  AppMain 
//  2pb_end 

WMain*  p=ZNEW  WMain(zString(2ResId(IDS_MAIN))); 

//  zpb_begin  AppMain2 
//  zpb_end 

goO: 

delete  p; 

//  zpb_begm  AppMainS 
//  zpb_end 

} 


#include  "outputh" 

//include  "^^cludc\omputh*' 
#include  <timeJi> 


int  ImtOutput(HINSTANCE  hlnstance){ 

WNDCLASS  wndclass; 

//dieck  to  see  if  die  class  is  already  registered 
id[GetClasslnfo(hlnstance,''C>utput''^WDdclass)) 
return  TRUE; 

//register  the  class 
wndcla&s.style 
wndclassJpfiiWndProc 
wndclass^cbClsExtra 
wndclass.cbWnd£xtra 
wndclassJilnstance 
wndclass  Jilcon 
wndclass  JiCursor 
wndclassJibrBackground 
wndclass  JpszMenuName  =NULL; 
wndclass.lpszCiassName 
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=  CS^HREDRA  W  |  CS^VREDRAW  |CS__DBLCLKS; 
OutputWndProc; 

10; 

10; 

=  hlnstance; 

=  LoadIcon(NULU  IDLAPPLICATION) ; 

=  LoadCursor(NULL,  IDC_ARROW); 

NULL; 

"Output"; 
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RegisterClass(&wndcIass); 

//make  sure  the  class  is  registered 
if(GetCIassInfo(hInstance,"Oulput",&wndc!ass)) 
return  TRUE; 

return  FALSE; 

} 


Ou^utWndProc 

Purpose 

Window  Message  Proc 


long  far  pascal  Ou^utWndProc(HWND  hwnd,UINT  message, WPARAM  wParam,LPARAM  lParam){ 


int 

int 

int 

int 

int 

char* 

SIZE 

RECT 

HDC 


t^y; 

oldnumlines; 

position; 

len; 

update; 

c; 

size; 

rect; 

hdc; 


OUTPUT* 

OUTPUTTIEM  *  itemlist; 


//*********************************************7^^*i^^*** 

//if  this  is  the  first  message  then  setup  the  data  strucure 
if(message  =  WM__NCCREATE){ 


//create  a  new  ou^ut  structure  and  store  it 
op  =  new  OUTPUT; 
SctWindowLong(hwnd,0,(long)op); 

//set  up  die  inital  variable  values 
op->font 
(^>numlines 

op->numscreenlines  =  0; 

op->numitemsloaded  =  0; 

op*>viewofifeet 
op->scrollrange 
op->niargin 
op->textcolor 
op->backcolor 
op->textalign 
op->enablelog 
op->datedlog 
op~>filename 
op->fj>tr 
op-^historysize 
<^>->items 
op->lmeheigbt 

<^>>>lastrowclicked  =-l; 

op“>hscrollrange 

op*>maxlinewidth 

op^hviewoffeet 

op->stamptype 

} 


=  NULL; 

-0; 


=  0; 

=  0; 

=  2; 

=  GetSysColor(COLOR_WINDOWTEXT); 
=  GetSysColor(COLOR_WINDOW); 

=  1;  //left 
=  FALSE; 

=  FALSE; 

=  NULL; 

=  NULL; 

=  0; 

=  NULL; 

=  0; 


=  0; 

=  0; 

=  0; 

=0; 
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//get  the  pointer  to  the  data  structure 
else{ 

op  =  (OUTPUT  ♦)GetWindowLong(hwnd,0); 

} 


ff*****************i^*******)¥******************i^******** 

//if  the  datastnicture  is  NULL  then  just  use  the  default  message  handling 
if(op==NULL){ 

return  Def^^%idowProc(hwnd4nessage,wParam4Param); 

} 


//♦♦♦♦♦  process  messages  ♦♦♦*♦ 
switch(message){ 

//******************m$i******************:^**i^*****^*t^*^ 

caseWM_CREATE:{ 

SendMessage(hwnd,WM_SIZE,0,0); 
return  1; 

} 

//  if  destroying  then  delete  all  data 
case  WM_NCDESTROY:{ 

if(op->items  !=  NULL){ 

for(  t  =  0 ;  t  <  op->numlines ;  t-hf){ 
il(op->items[t].string !“  NULL) 
delete[]  op->iteras[t],string; 

} 

delete[]  op->items; 

} 

if(op->filename  !=  NULL) 
delete[]  op->filename; 

if(op->^tr  !=  NULL) 
fclose(op->fptr); 

delete  op; 
op  =  NULL; 

SetWindowLong(hwnd,0,(iong)op); 
return  1; 

} 


II  if  sizing  then  get  die  new  number  of  lines 

//  then  allocate  or  delete  memory  for  die  new  number  of  lines 

caseWM_SI2E:{ 


//get  the  height  of  a  character 
hdc  =  GetDC(hwnd); 
id[op->font  !=NULL) 

SelectObject(hdc»op->font); 

GetTextExientPoint^dc,"X"  J  ,&size); 
op->lineheight  =  size.cy; 

ReIeaseDC(hwnd4idc); 

GetClientRect(hwnd,&op->clientrect); 

//get  the  number  of  total  rows  and  the  number  that  can  be  displayed 
oldnumlines  =  op->numlines;  //old  num  rows 
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rows 


op->numlines  —  (op“>clientrectbottoin  /  op->lineheight)  +1  +  op->historysize;  //new  num 


rows 


} 

//•••••••♦•*♦*•*• 

//  paint  the  window 
case  WM_PAINT:  { 


if(op->numlines  <  op->histoiysize)  //double  check 
op->numlines  =  op->historysize; 

op->numscreenlines  =  (op->clientrectbottom  /  op->lineheight)  + 1 ;  //number  of  visible 

if(op->numscreenlines  <  1)  //double  check 
op->nunilines  =  1; 

//adjust  the  view  ofifeet 
if(op->numlines  <=  op->numscreenlines) 
op->viewoffeet  =0; 

//realloc  the  mem 

itemlist  —  new  OUTPUTlTENflop->numlines]; 

//copy  die  info  from  the  old  list  to  the  new  one 
for(t=0;  t  <  op->numiines;tH-){ 
if(t  <  oldnumlines){ 

itemlist[t].string  =  op->items[t].string; 

itemlist[t].color  =  op->items[t].coIor; 

itemlist[t].align  =  op->items[t].align; 

itemlist[t].width  ='op'>items[t].width; 

} 

else{ 

itemlist[t].string  =  NULL; 
itemlist[t].widd)  =  0; 

} 

} 

//remove  the  old  info 
for(t==op->numlines;t<oIdnumlines;t++)  { 
id[op->items[t].string  !=NULL) 
delete[]  op->items[t].string; 
op->items[t].width  =  0; 

} 

delete[]  op->items; 

//reset  the  pointer 
op->items  =  itemlist; 

//adjust  the  number  of  loaded  items 
if(op->numitemsloaded  >  op->numlines) 

op->numitemsloaded  =  op->numlines; 

//adjust  the  scrollbars 
AdjustScrollBars(hwnd,op); 

return  I; 


//set  up  the  device  context 
hdc  ~  GetDC(hwnd); 
if(op->font  !=NULL) 

SelectObject(hdc,op->font); 

SetBkColor(hdc,op->backcolor); 

//get  the  client  area 
GetClientRect(hwnd,&rect); 
y=  rectbottom; 

if(  op>>numitemsloaded  >=  op->numscreenlines){ 
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op->viewoffset/op->lineheight; 
y  =  op->viewoffset%op->Imeheight; 
for(  t  =  rectbottom+y ;  t  >  0 ;  t-=  op->lineheight)  { 

//set  up  the  rectangle 

rectbottom  - 1; 

recttop  =  rectbottom  -  op->lmeheight; 

//setup  the  alignment 

if(op->items[x]^ign  — 1 ){  //left 

SetTextAlign(hdc,TA_LEFT); 
position  =  rectleft  +  op->margm; 

} 

else  ift;op->items[x].align  =2)  {  //center 

SetTextAlign(hdc,TA_CENTER); 
position  =  (rectright  -  rectleft)/2; 

} 

else  if(op->items[x].align  =3)  {  //right 

SetTextAIign(hdc,TA_RIGHT); 
position  =  rectright  -  op->margin; 

} 

//set  the  text  color 

SetTextColor(hdc,op->items[x].color); 

//draw  the  line 

ExtTextOut(hdc,position  -  op->hviewoffset^cttop  JETO_OPAQUE,&rect, 
op->items[x].string,lstrIen(op->items[x].string)»NULL); 


X++; 

} 

} 

else{ 

for(t  =  op->numitemsloaded  -l;t  >*0;t~){ 

//set  up  the  rect 

rectbottom  =  recttop  +  op->lineheight; 

//setup  the  alignment 

ift;op->items[t]^gn  =1 )  {  //left 

SetTcxtAlign(hdc,TA_LEFT); 
position  =  rectleft  +  op->margin; 

} 

else  ii(op->items[t].align  ==2)  {  //center 

SetTextAlign(hdc,TA_CENTER); 
position  =  (rectright  -  rectleft)/2; 

} 

else  if(op->items[t]^gn  =3){  //right 

SetTextAlign(hdc,TA_RIGHT); 
position  =  rectright  -  op->margin; 

} 

//set  the  text  color 

SetTextColor(hdc,op->items[t].coIor); 

//draw  the  text 

£xtTextOut(hdc,position>  op*54iviewoffset-  op- 

>hviewofi&etrecttopJETO_OPAQUE,&rect 

op->items[t].string4strlen(op->items[t].strmg)J'JULL); 
recttop  =  rectbottom; 

} 

rectbottom  =  y; 

ExtTextOut(hdc,rectleft,recttopJETO  OPAQUE,&rect"",0,NULL); 

} 

ReleaseDC(hwn(Uidc); 

ValidateRect(hwnd,NULL); 
return  1; 

} 

ff*mm****************0**********************m********** 

//mouse  cliclcs 

case  WM_LBUTTONDBLCLK: 
case  WM^RBUTTONDOWN: 
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case  WM_LBUTTONDOWN:{ 


//find  the  row  that  was  clicked  in 

if(  op->numitemsloaded  >=  op->numscreenlines){ 

y  =  op->clientrectbottom  -  (short)HIWORD(lParam)  +  op->viewoffset; 
op->lastrowcIicked  =  y  /  op->lineheight; 

} 

else{ 

y  =  (short)HIWORD(lParam); 

op->lastrowclicked  =  op->numitemsloaded  -  (y  /  op->lineheight)  -  I; 

if(message  =  WM_LBUTTONDOWN) 

SendNotilyMessage(hwnd,OPN_LCLICKED); 
else  ifijmessage  =  WM^RBUTTONDOWN) 

SendNotifyMessage(hwnd,OPN__RCLICKED); 
else  ifi[message  ==  WM_LBUTTONDBL(XK) 

SendNotifyMessage(hwnd,OPN__DCXICKED); 
return  0; 

} 

//set  the  new  font  then  recalc  the  number  of  lines 
caseWM_SETFONT:{ 

op->font  =  (HFONT)wParam; 

SendMessage(hwnd,WM_SIZE,0,0); 
return  1; 

} 

//vertical  scroll  bar 
case  WM__VSCROLL:{ 


y  =  op->viewoffset; 


switch(LOWORD(wParam))  { 

case  SB_BOTTOM  :{ 
op->viewoflfeet  =0; 
break; 

> 

case  SB_LINEDOWN:{ 

op->viewoffset  -=op->lineheight; 
break; 

} 

case  SB_LINEUP:{ 

op->viewofFset  +=op->lineheight; 
break; 

} 

case  SB_PAGEIX)WN:{ 

op->viewoffeet  -=  op->clientrectbottom; 
break; 

} 

caseSB_PAGEUP:{ 

op->viewoffset  +«  op->clientrectbottom; 
break; 

} 

case  SB^THUMBTRACK: 
case  SB_THUMBPOSmON:{ 

#ifdef  WIN32 

op->viewofiset  =  op*>scrollrange  -  HIWORD(wParam); 
#else 

op->viewof&et  =  op->scrollrange  -  LOWORD(lParam); 
#endif 
break; 

} 

caseSB_TOP:{ 

op*>viewoffi5et  =  op->scrollrange; 
break; 

} 

} 
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//check  the  range 
if(op->viewoffset  <  0) 

op->viewoffset  =  0; 
ifl;op->viewofFset  >  op->scrollrange) 
op->viewoffset  =  op->scrollrange; 

//check  for  change  in  position 
if(y  !=  op->viewoflfset){ 

//update 

SetScroIlPos(hwnd,SB_VERT,op->scrollrange  -  op->viewoffset,TRUE); 
InvaliclateRect(hwncU>IULL,TRlJE); 

} 

return  0; 

} 

^^^tti:$:$^t********************************************** 

//vertical  scroll  bar 
caseWM^HSCROLL:{ 

X  =  op->hviewoffset; 

switch(LOWORD(wParam))  { 
caseSB_BOTTOM:{ 

op->hviewoffset  =  op->scrolIrange;; 
break; 

} 

caseSB_LINEDOWN:{ 

op->hviewoffeet  +*=10; 
break; 

} 

case  SB_LINEUP:  { 

op->hviewoffset  — 10; 
break; 

} 

case  SB_PAGEDOWN;{ 

op->hviewoffset  +=  op->clientrectright; 
break; 

} 

caseSB_PAGEUP:{ 

op->hviewofifeet  -=  op->clientrectright; 
break; 

case  SB_THUMBPOSrnON: 
case  SB_THUMBTRACK:{ 

#ifdef  WIN32 

op->hviewofl65et  =  HrWORD(wParam); 

#else 

op->hviewoflfeet  =  LOWORD(lParam); 

#endif 

break; 

} 

caseSB_TOP:{ 

op->hviewofi&et  =  0; 
break; 

} 

} 

//check  the  range 
if(op->hviewoffeet  <0) 

op->hviewoffset  =0; 
if(op->hviewoffeet  >  op->hscrolirange) 

op->hviewofi&et  =  op->hscrollrange; 

//check  for  change  in  position 
if(x  !=  op->hviewoffeet){ 

//update 

SetScrollPos(hwnd,SB_HORZ,op->hviewoffset,TRUE); 

lnvalidateRect(hwn(U^ULL,TRlJE); 

} 

return  0; 
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} 

//add  a  new  line  of  text 
caseOP_ADDLINE:{ 


//params 

c  =  (char  *)lParam; 

position  =  wParam; 
if(position  <0) 

position  =  0; 


//check  to  see  if  the  line  being  remove  was  the  widest 
/^  so  then  find  die  new  widest  item 
X  -  op->numlines  - 1 ; 

if(op->items[x].width  =  op->maxlinewidth){ 
op->maxlinewidth 
op->items[x].vddth  =0; 
for(t=0;t<  op->numlines;M-i-){ 

if(op->items[t].width  >  op->maxlinewidth) 
op->maxlinewidth  =  op->items[t].wdth; 

} 

} 

//remove  the  last  string  -  at  the  very  end  of  the  list 
if(op“>items[x].string  !=NULL) 
delete[]  op->items[x].string; 


//move  all  the  strings  color  and  alignment  info  above  the 
//specified  entry  position 
for(t=<op->numUnes- 1  );t>position;t~)  { 

op->items[t].string  ==  op->items[t-l].string; 
op->items[ti.color  =  op->items[t-l]xolor, 
op->items[t].align  =  op->items[t-l  ],align; 
op->items[t]-width  =  op->items[t-l].width; 

} 

//add  the  new  string  color  and  alignment  info 
if(c  =  NULL) 
c“""; 

//copy  die  string  and  expand  tabs 
op->items[position].string  =  ExpandTabs(c ); 

op->items[position]xolor  =  op->textcolor, 
op->items[position].align  =  op->textalign; 

//get  the  width  of  die  string 
hdc  =  GetE)C(hwnd); 
if(op->font  NNULL) 

SelectObject(hdc»op->font); 
GetTextExtentPoint(>dc,c4strlen(c)»&si2e); 
op->items[position].width  =si2e.cx; 
ReleaseDC(hwn(Uidc); 

//check  to  see  if  this  is  a  max  widdi 
if(op->maxlinewiddi  <  size.cx ) 

op->maxlinewiddi  =  size.cx; 

//adjust  the  number  of  items  loaded 
op->numitemsIoaded-H-; 
ii(op->numitemsloaded  >  op->numlines) 

op->numitemsloaded  =  op->numlines; 

/rif  logging  then  add  the  line  to  the  log 
ii(op->enablelog)  { 

WriteToLog(op,&oi>->items[position]); 

} 
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//adjust  the  scrollbars 
ifl[op*>viewoffset  >  0) 

op->viewofl&et  +=  op->lineheight; 
AdjustScroIlBars(hwnd,op); 


//re«draw 

InvalidateRect(hwndJMULL,TRUE); 
return  1; 

} 

case  OP^ADDSTAMPEDLINE:{ 

len  =  lstrlen((LPSTR)IParam)  +30; 
c  =  new  char[len]; 

GetTimeDateStamp(c^O,op->stamptype); 
lstrcat(c,” "); 

lstrcat(c,(LPSTR)lParam); 

SendMessage(hwnd,OP_ADDLINE,wParam,(LPARAM)c); 
delete[]  c; 


} 


return  1; 


case  OP_SETMARGINS:{ 

//check  for  a  valid  range 
if((int)wParam  >=0  &&  wParam  <1000)  { 
op->niargin  =  wParam; 

//re-draw 

InvalidateRect(hwn<UvnJLL,TRUE); 
return  TRUE; 

} 

return  FALSE; 

} 


case  OP^SETTEXTALIGN:  { 

//check  for  a  valid  range 
if(  wParam  >0  &&  wParam  <4){ 
op->textalign  =  wParam; 

//re-draw 

InvaIidateRect(hwn(U>JULL,TRUE); 
return  TRUE; 

} 

clse{ 

op->te?ctalign  =  1; 

} 

return  FALSE; 

} 


case  OP_CLEAR:  { 


op->items[t].widdi  =  0; 


//delete  all  strings 
if(op->items  !=  NULL){ 

for(t=0,'t<op->numlines;t++)  { 

if(op->items[t].string!=NULL)  { 
delete[]  op->items[t).string; 
op->items[t].string  =  NULL; 

> 


} 


) 


op->numitemsloaded  =0; 

op->viewof!set  =0; 

SetScrollRange(hwnd,SB_VERT,0,0,TRUE); 
op->maxlinewidth  =0; 

op->hviewofifset  =0; 

SetScrollRange(hwnd,SB_HORZ,0,0,TRUE); 
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//re-draw 

InvalidateRect(hwncU^L,TRUE); 
return  1; 

} 

case  OP_SETTEXTCOLOR:{ 

//set  the  color 

op->textcoIor  =  (COLORREF)lParam; 

//re-draw 

InvaHdateRect(hwncUNlULL,TRUE); 
return  1; 

} 

^y***4t4(***««««**««**^***«**#4(****4t*4t«4t4t*«4eik«*«4t4c*««4c*«4r 

case  OP_SETBACKCOLOR:  { 

//set  the  color 

op->backcolor  =  (COLORREF)lParam; 

//re-draw 

InvalidateRect(hwndJ'^lJLL,TRUE); 
return  1; 

} 

case  OP_SETLOGNAME:{ 

if(op->filename  !=  NULL) 
delete[]op->filename; 

op->filename  =  new  char[lstrlen((LPCSTR)lParam)+l]; 
lstrcpy(op~>filename,(LPCSTR)lParam); 

//if  logging  is  enabled  then  open  the  log 

OpenLogFile(op); 

return  1; 

} 

//♦♦♦♦♦♦♦♦♦♦♦♦♦♦***************^***^******^^^^^^^^^^^,^^ 

case  OP__ENABLELOG:{ 

if(wParam  =0) 

op->enabIeIog  =  FALSE; 

else{ 

op->enablelog  =  TRUE; 

/Af  log^g  is  enabled  dien  open  the  log 
(^enLogFile(op); 

} 

return  op->enablelog; 

} 

//***********mmm****tmm******m**m****m****:^**t^**i^*****^ 

case  OP^DATEDLOGGING:  { 

if(wParam  =0) 

op->datedlog  =  FALSE; 

else{ 

op->datedlog  =  TRUE; 

/Af  logging  is  enabled  then  open  the  log 
OpenLogFile(op); 

} 

return  op->datedIog; 

} 

case  OP^HISTORYSIZE:  { 

//set  the  history  size 
op->iiistorysize  =  wParam; 
i^op-54u$torysize  <  0) 
op->historysize  =0; 
if(op->historysi2e  >  1000) 

op->historysi2e  =  1000; 

//call  WM_SIZE  to  readjust 
SendMessage(hwnd,WM_SIZE,0,0); 
return  op->historysize; 

} 
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case  OP_GETROWCLICKED:{ 

return  op->Iastrowclicked; 

} 


case  OP_GETTEXTLENGTH:{ 

if((int)wParam  >=0  &&  (int)wParam  <  op->numscreenlines){ 
return  lstrlen(op->items[wParam].string); 

} 

else{ 

return  0; 


case  OP_GETTEXT:  { 

i^(int)wParam  &&  (int)wParam  <  op->numscreenlines){ 
lstrcpy((LPSTR)lParam,op->items[wParam].string); 
return  TRUE; 

} 

return  FALSE; 

} 

//«****««**««*«<»*****«**«*««4t«*«**««***««««««*«««*««4t4i« 

case  OP__DELETELINE:{ 

if((mt)wParain  >=0  &&  (mt)wParam  <  op>>nuniitemsloaded){ 


//check  to  see  if  the  line  being  removed  was  the  widest 
/Af  so  then  find  the  new  widest  item 
if(op->items[wParam].width  op->maxIinewidth){ 
op*>maxlmewidth  =0; 
op->items[wParam].width  =0; 
for(1r=0,*t<  op->numlines;t++){ 

if(op->items[t].width  >  op->maxlinewidth) 
op->maxIinewidth  =  op->items[t].width; 

} 

} 


//delete  the  string 

if(op->items[wParam].slring  !=  NULL) 
delete[]  op->items[wParam],string; 

//shift  items  down  one 

for(t=wParam ;  t<  (op->numitemsloaded  -1);  t++){ 
op->items[t].string  =  op->itenis[t+l].string; 
op->items[t].color  =  op->items[t+l]xolor; 
op->items[tj.align  =  op->items[t+l]^ign; 
op->items[t]  .width  =  op->items[t+l  ]. width; 

} 

op->items[t].string  =  NULL; 

op->items[t].widlh  =0; 


op->numitemsloaded 


//adjust  the  scrollbars 
AdJu5tScroIlBars(hwnd,op); 

//re-draw 

lnvalidateRect(hwn<LNUmTRU£); 


return  TRUE; 

} 

return  FALSE; 

} 

case  OP_UPDATELINE:{ 


//check  the  range 

if((int)wParam  <0  ||  (int)wParam  >=  op->numitemsloaded){ 
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return  FALSE; 

} 

//get  the  params 

c  =  (char  ♦)lParam; 

position  =  wParam; 


//check  to  see  if  the  line  being  updated  was  the  widest 
//if  so  then  find  the  new  widest  item 
i^op->items[position].widdi  =  op->maxlinewidth) 
update  =  TRUE; 
else 

update  =  FALSE; 

//add  in  extra  lines  if  ness. 
if(position  >=  op->numitemsloaded){ 

for(t  =  op->numitemsioaded;  t<position;tf+){ 
op->items[t].string  =  new  char[2]; 
lstrcpy(op->items[t].string,”"); 
op->items[t].color  =  op->textcolor; 
op->items[t].align  =  op->textalign; 
op->items[t].width  =  0; 

} 

op->numitemsloaded  =  position  +1; 

} 


//update  the  specified  line 
ifi;  op->items[position].string  !=  NULL) 
delete[]  op->items[position].string; 
op->iteins[position].string  =  new  char[lstrlen(c>f  1]; 
lstrcpy(op->items[position].string,c); 
op->items[position].color  =  op->textcolor, 
op->items[position].align  =  op->textalign; 
op->items[position].width  =  0; 

/fif  update  is  true  then  find  the  widest  line 
if(update){ 

op->maxlinewidth  =0; 
op->items[wParam].width  =0; 
for(t=0;t<  op->numlines;t++){ 

ifi[op->items[t]  .width  >  op->maxlinewidth) 
op<>maxlinewidth  =  op->items[t].width; 

} 

} 


//re-draw 

InvalidateRect(hwndJt>JULL,TRUE); 


} 


return  TRUE; 


//**♦***♦♦*♦♦***♦•*••♦♦•♦**♦♦*••♦♦♦♦♦♦***♦♦* 

case  OP_STAMPSTYLE:  { 


} 


if(wParam  =  FALSE) 

op->stamptype  =  FALSE; 
else 

op->stamptype  =  TRUE; 
return  op->stamptype; 


case  OP^GETNUMLINES:  { 

return  op->nuniitemsloaded; 

} 


case  OP_UPDATESTAMPEDLINE:{ 


len  =  lstrlen((LPSTR)lParam)  +30; 
c  “  new  char[len]; 
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GetTimeDateStamp(c^O,op->stamptype); 
lstrcat(c,"  "); 

lstrcat(c,(LPSTR)lParam); 

SendMessage(hwnd,OP_UPDATELINE,wParam,(LPARAM)c); 
delete[]  c; 


} 

return  Def>MndowProc(hwnd4nessage,wParam,IParain); 

} 

^ifttittm0***************t^*********^**************f 

int  OpenLogFile(OUTPUT  ♦  op){ 

char  *path; 

int  extensionjen; 

chardate[10]; 

//check  to  see  if  logging  is  enabled 
if(op->enabIelog  =  FALSE)  { 
return  FALSE; 

} 

//alloc  a  string  for  the  filepath 

path  =  new  char[lstrlen(op->filename)+10]; 

//close  old  log  file  if  open 

if(op->fptr!=NULL) 

fcIose(op>>^tr); 

//get  the  logEle  name  if  dated  logfiles  are  used 
if(op->datedlog){ 

//get  the  date 

GetDateStringfop.date,  1 0); 

//find  where  the  filename  extension  is 

len  =  lstrlen(op->filename); 

forfextension  =0;extension  <  len  ;extension"H‘){ 

if(op->filename[extension]='.') 

break; 

} 

if(extension  1=  Ien){ 

op->filename[extensionf=0; 

wsprintf(padi,"%s%s.%s’’,op->filename.date,&op->filename[extension+ 1  ]); 
op->filename[extension]-.'; 

} 

else{ 

wsprintf(path,**%s%s",op->filename,date); 

} 

} 

else{ 

lsm:py(path,op->filename); 

} 

//open  the  log  file 
op->fptr  =  fopen(palh,"a+"); 

delete[]  path; 

if(op->^  !=  NULL) 

return  TRUE; 

return  FALSE; 

} 
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int  WriteToLog(OUTPUT  *op*OUTPUnTEM  ♦item){ 


tiine_t  tt; 

struct  tm  *  systime; 


//check  the  date  if  datedlogging 
if(op->datedlog){ 

//get  the  time/date 
tt  =  tiine(NULL); 
systime  =  localtime(&tt); 

//store  the  current  date 

if(op->logday  !=  systime->tm_mday  ||  op->logmon  !=  systime->tm_mon  || 
op->Iogyear  !=  systime->tin_year){ 

OpenLogFile(op); 

} 

} 

//write  the  line 

fwrite(item->strmg,sizeof(char)4strlen(item->string),op->§)tr); 
fwrite(”\n'’^i2eof(char),  1  ,op->fptr); 


return  TRUE; 

} 


int  GetDateString(OUTPUT  *opJLPSTR  string,int  len){ 


time_t  t; 

struct  tm  *systime; 


if(len<7) 
return  FALSE; 


//get  the  time/date 
t  =  time(NULL); 
systime  =  localtime(&t); 

//store  die  current  date 
op->Iogday  =  systime->tm__mday; 
op->logmon  =  systime->tm_mon; 
op->logyear=  systime->tm_year, 

wsprintf(string,"%2  J2d%2 J!d%2^d"^stime->tm_year^ystime->tm  mon+ 1 , 
systime->tm_mday); 


} 

/•• 


return  TRUE; 

type  0  -  date  +  time 


int  GetTimeDateStamp(LPSTR  stTing4nt  len^nt  type){ 


1  -  time  only 

**/ 


time_t  t; 

struct  tm  *systime; 


if(Ien<18) 
return  FALSE; 


//get  the  time/date 
t  =  time(NULL); 
systime  =  localtime(&t); 

if(type  =0){ 

wsprintfi;string,"%2.2d/%2^d/%2ad%2^d:%2^<l:%2^d". 
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sy  stime->tm_mday  ,systime->tm_mon+ 1  ,systime->tm_year, 
systime->tm_hour,systime->tm_min^ystime->tm__sec); 

} 

else  i^type  =1){ 

wsprintf(string,’To2^d:%2.2d:%2.2d", 

systime->tm_hour,systiine->tm_min3ystiine->tm_sec); 

} 

return  TRUE; 


long  SendNotifyMessage(HWND  hwnd,int  message)  { 

#ifdef^WIN32 

long  ID  =  GetWmdowLong(hwnd,GWL_ID); 

return  SendMessage(GetParent(hwnd),WM_COMMANDM^iUELPARAM(ID^essageX(LPARAM)hwnd); 
#else 

WORD  ID  =  GetWmdowWord(hwnd,GWW_ID); 

return  SendMessage(GetPaTent^wndXWM_COMMANDJD>lAKELPARAM(hwnd4nessage)); 

#endif 

} 

int  AdjustScrollBars(HWND  hwnd,OUTPUT  *op){ 

//adjust  the  vertical  scroll  bar 

ii((op->numitemsloaded  ♦  op->lineheight)  >  op->clientrectbottom ){ 
op->scrollrange  =  (op->numitemsloaded  ♦  op->lineheight)  -  op->clientrectbottom  -  1; 
i^op->viewofifeet  >  op->scrollrange) 

op->viewoffset  =  op->scrollrange; 
SetScrollRange(hwnd,SB_VERT,0,op->scrollrange4^ALSE); 

SetScrollPos(hwnd,SB_VERT,op->scrollrange  -  op->viewoffset,TRUE); 

} 

else{ 

SetSCTollRange(hwnd,SB__VERT,0,0,TRUE); 
op*>viewofl&et  =  0; 

} 

//adjust  die  horizontal  scrollbar 

if((op->maxlinewidth  +  op->mar^*2)  >  op->cUentrectjright){ 
op>>hscrollrange  =  (op->maxlmewidth  +  op->mar^*2)  -  op->clientrectright; 
id;op->hviewoffset  >  op‘>hscrollrange) 

op->hviewofifeet  -  op->hscroIlrange; 
SetScrollRange(hwnd,SB_HORZ,0,op->hscrollrange,TRUE); 
SetScrollPos(hwnd,SB_HORZ,op->hviewoffset,TRUE); 

} 

else{ 

SetScrollRange(hwnd,SB_HORZ,0,0,TRUE); 
op->hviewoffeet  =0; 

} 

return  TRUE; 

} 


LPSTR  ExpandTabs(LPSTR  in)  { 
intt; 

int  num  =0; 

int  len  =  Istrien(in); 

intpos; 

LPSTR  out; 

for^tr=0;t<len;M-+)  { 
if(in[t]==9) 

num++; 
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> 


num  =  (num*5)+len; 
out  =  new  char[num+l  ]; 
pos  =0; 

for(t=0;t<len;t++)  { 

m[t]=9){ 


} 


} 

else{ 


} 

out[pos]=0; 

return  out; 


out[pos]=32; 

pOS-H-; 

out[pos]=32; 

pOS++; 

out[pos]=32; 

pOS-H-; 

out[pos]=32; 

pos-H-; 

out[pos]=32; 

pos-H-; 


out[pos]=in[t]; 

pOS++; 


#include  <windows  Ji> 

#include  <stdio  Ji> 

#mclude  <io  Ji> 

#indude  <winsockii> 

#mclude  "routinesii" 

long  GetFileTuneCLPCSTO  filenameJTTME  *  ft){ 

FILE  •fptr; 
intrt; 

/*  create  a  file  containing  10  bytes  */ 
^  =  fopen(filename,'’r"); 

rt  =  getftiine(fileno(fptr),(ftime*)ft); 

/•close  the  file  ♦/ 
fclose(Q)tr); 

if(rt  «0) 

return  TRUE;  //success 
return  FALSE; 

} 


long  GctFUeSizeCLPCSTR  filename)  { 

FILE  •^nr; 
long  size; 

/•  create  a  file  containing  10  bytes  •/ 
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fptr  =  fopen(fiIenaine,  V); 

size  =  filelength(fileno(fptr)); 

/♦  close  the  file  */ 
fclose(fptr); 

return  size; 

} 

int  FixFilename(LPSTR  filename)  { 
intt^ 

int  len  =  lstrlen(filename); 


for(t=0;t<len;t-H-)  { 
if(fflename[t]=*/)  { 

filename[t]=^V; 

} 

} 

//check  for  two  in  a  row 
for(t=0;t<!en;t++)  { 
if(filename[t]=^V){ 

if(filename[t+ 1  ]=^V)  { 

for(x=tpc<lenpc++)  { 

filename[x]  =filename[x+l]; 

} 


return  TRUE; 

} 

/«««**»««i»*«**«««*4t4t**«t*«**««««***«*«*«4(««*)»*««*«4(** 

return 

0>  success 

1  -  address  string  is  not  long  enough 

2  -&iled 

int  GetClientAddressFromName(LPSTR  address4Dt  maxaddrlenJ^PCSTR  name){ 

hostent  •pHostent; 
int  len; 

pHostent  -  getfaostbyname  (name); 

if(pHostent=NULL) 
return  2; 

len  =  lstrlen(pHostent->ii_addr_list[0]); 
if(len  >  (maxaddrlen-l)) 
return  1; 

lstrcpy(address,pHostcnt->h_addr_list(0]); 
return  0; 

} 

fmm*^*m**m****m******************0******0*********** 

0- success 

1  *  address  string  is  not  long  enough 
2-failed 

mmm***0m*************^it*****************************f 
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int  GetClientNameFromAd<iress(LPSTR  name,int  maxnamelenJLPCSTR  address)  { 

unsigned  long  addr; 
hostent  ♦pHostent; 
intlen; 

addr  =  inet_addr  (address); 

pHostent  =  gethostbyaddr((char*)&addr,4JPF_INET); 

if(pHostent==NULL) 
return  2; 

len  =  lstrIen(pHostent->h_name); 

if(Ien  >  (maxnameIen-1)) 
return  1; 

lstrcpy(name,pHostent->h__name); 
return  0; 


} 


SAMPLE  DATA  FILE  USED  IN  DEMONSTRATION  IS  CALSSIFIED  AND 
CAN  NOT  BE  INCLUDED  HERE 
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INITIAL  DISTRIBUTION  LIST 


1.  Defense  Technical  Information  Center . 2 

8725  John  J.  Kingman  Road,  Suite  0944 

Fort  Belvoir,  VA  22060-6218 

2.  Dudley  Knox  Library . 2 

Naval  Postgraduate  School 

Monterey,  CA  93943 

3.  Center  for  Naval  Analysis . 1 

4401  Ford  Ave. 

Alexandria,  VA  22302 

4.  Dr.  Ted  Lewis,  Chairman,  Code  CS/L . 1 

Computer  Science  Dept. 

Naval  Postgraduate  School 
Monterey,  CA  93943 

5.  Chief  of  Naval  Research . 1 

800  Nordi  Quincy  St. 

Arlington,  VA  222 17 

6.  Eh".  Luqi,  Code  CS/Lq . 1 

Computer  Science  Dept. 

Naval  Postgraduate  School 
Monterey,  CA  93943 

7.  Dr.  Marvin  Langston . 1 

1225  Jefferson  Davis  Highway 

Crystal  Gateway  2  /  Suite  1500 
Arlington,  VA  22202-4311 

8.  David  Hislop . 1 

U.S.  Army  Research  Office 

POBox  12211 

Research  Triangle  Park,  NC  27709-221 1 

9.  Capt.  Talbot  Manvel . 1 

Naval  Sea  Systems  Command 

2531  Jefferson  Davis  Hwy. 

Attn:  TMS  378  Capt.  Manvel 
Arlington,  VA  22240-5150 
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10.  CDR  Michael  McMahon . 

Naval  Sea  System  Command 

253 1  Jefferson  Davis  Hwy. 

Arlington,  VA  22242-5160 

. 1 

1 1.  Dr.  Elizabeth  Wald . 

.  1 

Office  of  Naval  Research 

800  N.  Quincy  St. 

ONR  CODE  311 

Arlington,  VA  22217-5660 

12.  Dr.  Ralph  Wachter . 

Office  of  Naval  Research 

800  N.  Quincy  St. 

CODE  311 

Arlington,  VA  22217-5660 

. 1 

13.  Army  Research  Lab . 

115  O'Keefe  Building 

Attn:  Mark  Kendall 

Atlanta,  GA  30332-0862 

. 1 

14.  National  Science  Foundation . 

Attn:  Bruce  Barnes 

Div.  Computer  &  Computation  Research 

1800GSt.NW 

Washington,  DC  20550 

. 1 

15.  National  Science  Foundation . 

Attn:  Bill  Agresty 

4201  Wilson  Blvd. 

Arlington,  VA  22230 

. 1 

16.  Hon.  John  W.  Douglass . 

Assistant  Secretary  of  the  Navy 
(Research,  Development  and  Acquisition) 

Room  E741 

1000  Navy  Pentagon 

Washingotn,  DC  20350-1000 

. 1 
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17.  Technical  Library  Branch . 

Naval  Command,  Control,  and  Ocean  Surveillance  Center 
RDT&E  Division,  Code  D0724 
San  Diego,  CA  92152-5001 

18.  Head,  Command  and  Control  Department . 1 

Naval  Command,  Control  and  Ocean  Surveillance  Center 

RDT&E  Division,  Code  D40 
San  Diego,  CA  92152-5001 

19.  Head,  Integration  and  Interoperability  Division . 1 

Naval  Command,  Control  and  Ocean  Surveillance  Center 

RDT&E  Division,  Code  D45 
San  Diego,  CA  92152-5001 

20.  Michael  W  DaBose,  Technology  Development  and  Insertion  Group . 1 

Naval  Command,  Control  and  Ocean  Surveillance  Center 

RDT&E  Division,  Code  D4525 
San  Diego,  CA  92152-5001 
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